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": "Schedule demo call",
    "description": "Lead interested in enterprise plan",
    "priority": "HIGH",
    "due_date": "2025-01-25T14:00:00Z"
  }'

{
  "success": true,
  "message": "Task created successfully",
  "data": {
    "task_id": 789,
    "email_lead_map_id": 2433664091,
    "name": "Schedule demo call",
    "priority": "HIGH",
    "due_date": "2025-01-25T14:00:00Z"
  }
}
Create actionable tasks linked to leads. Essential for managing follow-ups, tracking action items, and team collaboration.

​
Overview

Creates a task associated with a specific lead to track follow-up actions and ensure nothing falls through the cracks.

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
email_lead_map_id
number
required
Lead-campaign mapping ID
​
name
string
required
Task title/name
​
description
string
Detailed task notes (optional)
​
priority
string
default:"MEDIUM"
Task priority: LOW, MEDIUM, or HIGH
​
due_date
date
Due date in ISO 8601 format (optional)
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": "Schedule demo call",
    "description": "Lead interested in enterprise plan",
    "priority": "HIGH",
    "due_date": "2025-01-25T14:00:00Z"
  }'

​
Response Example

{
  "success": true,
  "message": "Task created successfully",
  "data": {
    "task_id": 789,
    "email_lead_map_id": 2433664091,
    "name": "Schedule demo call",
    "priority": "HIGH",
    "due_date": "2025-01-25T14:00:00Z"
  }
}