Skip to main content
POST
/
api
/
v1
/
master-inbox
/
create-task
curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/create-task?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email_lead_map_id": 2433664091,
    "name": "Follow up on enterprise proposal",
    "description": "Send pricing breakdown for 50-seat plan",
    "priority": "HIGH",
    "due_date": "2025-12-15T09:00:00Z"
  }'

{
  "ok": true,
  "data": {
    "id": 789,
    "email_lead_map_id": 2433664091,
    "name": "Follow up on enterprise proposal",
    "description": "Send pricing breakdown for 50-seat plan",
    "priority": "HIGH",
    "due_date": "2025-12-15T09:00:00Z",
    "created_at": "2025-12-01T10:00:00.000Z"
  }
}
Create follow-up tasks for leads with priorities and due dates. Tasks appear in the master inbox for easy tracking.

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
email_lead_map_id
number
required
The campaign-lead mapping ID
​
name
string
required
Task name/title
​
description
string
Detailed task description
​
priority
string
Task priority level. Values: LOW, MEDIUM, HIGH. Default: MEDIUM
​
due_date
string
Due date in ISO 8601 format (e.g., 2025-12-15T09:00:00Z)
curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/create-task?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email_lead_map_id": 2433664091,
    "name": "Follow up on enterprise proposal",
    "description": "Send pricing breakdown for 50-seat plan",
    "priority": "HIGH",
    "due_date": "2025-12-15T09:00:00Z"
  }'

​
Response Codes

​
200
Success
Request successful
​
400
Bad Request
Invalid request parameters or malformed request body
​
401
Unauthorized
Invalid or missing API key
​
422
Validation Error
Request validation failed. Check parameter types and constraints.
{
  "ok": true,
  "data": {
    "id": 789,
    "email_lead_map_id": 2433664091,
    "name": "Follow up on enterprise proposal",
    "description": "Send pricing breakdown for 50-seat plan",
    "priority": "HIGH",
    "due_date": "2025-12-15T09:00:00Z",
    "created_at": "2025-12-01T10:00:00.000Z"
  }
}