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"
}
}
{
"message": "Invalid API Key"
}
Lead Tasks
Create Lead Task
Create a task for a specific lead in a campaign
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"
}
}
{
"message": "Invalid API Key"
}
Create follow-up tasks for leads with priorities and due dates. Tasks appear in the master inbox for easy tracking.
Query Parameters
string
required
Your SmartLead API key
Request Body
number
required
The campaign-lead mapping ID
string
required
Task name/title
string
Detailed task description
string
Task priority level. Values:
LOW, MEDIUM, HIGH. Default: MEDIUMstring
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
Success
Request successful
Bad Request
Invalid request parameters or malformed request body
Unauthorized
Invalid or missing API key
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"
}
}
{
"message": "Invalid API Key"
}