Skip to main content
POST
/
api
/
v1
/
master-inbox
/
assigned-me
curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/assigned-me?api_key=YOUR_KEY&fetch_message_history=false" \
  -H "Content-Type: application/json" \
  -d '{
    "offset": 0,
    "limit": 20,
    "filters": {
      "emailStatus": "Replied",
      "leadCategories": {
        "isAssigned": true,
        "categoryIdsIn": [1]
      },
      "replyTimeBetween": ["2025-01-01T00:00:00Z", "2025-01-31T23:59:59Z"]
    },
    "sortBy": "REPLY_TIME_DESC"
  }'

{
  "messages": [
    {
      "id": "msg_123",
      "campaign_lead_map_id": "2433664091",
      "lead": {
        "email": "john@company.com",
        "first_name": "John",
        "last_name": "Doe"
      },
      "campaign": {
        "id": 12345,
        "name": "Q1 2025 Outreach"
      },
      "last_message": {
        "subject": "Re: Partnership Opportunity",
        "body": "I'm interested in learning more...",
        "received_at": "2025-01-15T14:30:00Z"
      },
      "email_status": "Replied",
      "category": {
        "id": 1,
        "name": "Interested"
      },
      "assigned_to": {
        "id": 456,
        "name": "Jane Smith"
      },
      "is_read": false
    }
  ],
  "total_count": 1,
  "offset": 0,
  "limit": 20
}
View your personalized inbox showing only leads and conversations assigned to you. Essential for team collaboration and individual accountability.

​
Overview

Retrieves all emails assigned to the authenticated user across all campaigns. This endpoint provides a personalized view for team members to focus on their assigned leads. Key Features:
  • Personalized inbox view for individual team members
  • Same comprehensive filtering as other inbox endpoints
  • Track assigned lead performance and engagement
  • Enable accountability in team-based campaigns
Use Cases:
  • Individual dashboards: Show team members only their assigned work
  • Performance tracking: Monitor individual team member metrics
  • Load balancing: View current assignment distribution
  • Task management: Track follow-ups on assigned leads

​
Query Parameters

​
api_key
string
required
Your SmartLead API key
​
fetch_message_history
boolean
default:"false"
Include full email thread history. Set to true to get complete conversation context.

​
Request Body

​
offset
number
default:"0"
Number of records to skip for pagination. Must be non-negative.
​
limit
number
default:"20"
Number of records to return per page. Must be between 1 and 20.
​
filters
object
Advanced filtering options
​
sortBy
string
default:"REPLY_TIME_DESC"
Sort order for results
  • REPLY_TIME_DESC: Most recent replies first (default)
  • SENT_TIME_DESC: Most recently sent emails first
curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/assigned-me?api_key=YOUR_KEY&fetch_message_history=false" \
  -H "Content-Type: application/json" \
  -d '{
    "offset": 0,
    "limit": 20,
    "filters": {
      "emailStatus": "Replied",
      "leadCategories": {
        "isAssigned": true,
        "categoryIdsIn": [1]
      },
      "replyTimeBetween": ["2025-01-01T00:00:00Z", "2025-01-31T23:59:59Z"]
    },
    "sortBy": "REPLY_TIME_DESC"
  }'

​
Response Codes

​
200
Success
Request successful - assigned emails retrieved
​
401
Unauthorized
Invalid or missing API key
​
422
Validation Error
Invalid request parameters (e.g., limit > 20, invalid date format)
​
500
Internal Server Error
Server error occurred
{
  "messages": [
    {
      "id": "msg_123",
      "campaign_lead_map_id": "2433664091",
      "lead": {
        "email": "john@company.com",
        "first_name": "John",
        "last_name": "Doe"
      },
      "campaign": {
        "id": 12345,
        "name": "Q1 2025 Outreach"
      },
      "last_message": {
        "subject": "Re: Partnership Opportunity",
        "body": "I'm interested in learning more...",
        "received_at": "2025-01-15T14:30:00Z"
      },
      "email_status": "Replied",
      "category": {
        "id": 1,
        "name": "Interested"
      },
      "assigned_to": {
        "id": 456,
        "name": "Jane Smith"
      },
      "is_read": false
    }
  ],
  "total_count": 1,
  "offset": 0,
  "limit": 20
}

​
Common Workflows

​
Daily Task Check

# Get all my unread assigned leads
payload = {
    "filters": {
        "emailStatus": "Replied",
        "leadCategories": {"isAssigned": True}
    },
    "limit": 20
}
response = get_assigned_me(payload)

​
Hot Leads Follow-up

# Get interested leads assigned to me
payload = {
    "filters": {
        "leadCategories": {
            "isAssigned": True,
            "categoryIdsIn": [1]  # Interested
        }
    },
    "sortBy": "REPLY_TIME_DESC"
}
response = get_assigned_me(payload)

​
Campaign-Specific View

# See my assigned leads in specific campaign
payload = {
    "filters": {
        "campaignId": 12345
    },
    "limit": 20
}
response = get_assigned_me(payload)

​
Performance Tips

  1. Use pagination: Default limit of 20 is optimal for response time
  2. Disable message history: Set fetch_message_history=false for list views
  3. Filter smartly: Combine filters to reduce result set
  4. Sort appropriately: Use REPLY_TIME_DESC for action-oriented views