Create a call task
create_call_task (MCP) · POST /api/tasks (REST)
Fields
| Field | Type | Notes |
|---|---|---|
phone | string, required | US number in any format; normalized to E.164. |
goal | string, required | 3–300 chars. One sentence the caller can act on. |
brief | string, required | 10–4000 chars. See writing briefs. |
consent | enum, required | inquiry · express_written · existing_customer · b2b_main_line |
state or timezone | string, one required | 2-letter US state or IANA timezone; drives calling hours. |
business_name, lead_name | string | Shown to the caller. |
links | array | Up to 10 {label, url}. |
deadline_minutes | int | 5–10080. Unclaimed tasks expire after this. |
webhook_url | url | Receives task.completed. |
external_ref | string | Your ID, echoed back. |
What's checked
- The number is valid, US, and not on your do-not-call list (or blocked platform-wide).
- You don't already have an open task for the same number.
- A timezone can be resolved for calling hours.
Response
{
"id": "task_9f2c1a…",
"status": "open", // "review" when free calls are used up and no plan is active
"business_name": "Bright Smile Dental",
"phone": "+15125550142",
"timezone": "America/Chicago",
"state": "TX",
"lead_local_time": "10:04 AM CDT",
"callable_now": true,
"goal": "Book a 15-minute call to walk through their site grade",
"consent": "inquiry",
"outcome": null,
"sla": {
"first_dial_within_minutes": 5,
"dial_by": "2026-10-06T15:09:12.000Z",
"first_dial_at": null,
"met": null
},
"created_at": "2026-10-06T15:04:12.000Z",
"deadline_at": "2026-10-06T16:04:12.000Z"
}
Response SLA
Every dispatched task gets a dial_by time 5 minutes after it's created. The clock only runs during the lead's calling hours, so a task created at 11pm local is due shortly after 9am. sla.met is set once the caller dials. Tasks in review start their clock when they're released.