Product
MCP serverREST APICaller appChatGPT, Claude & Muse
Use cases
Lead follow-upAI SDR phone stepAgencies
Developers
DocumentationQuickstartSandboxllms.txt
More
CustomersPricingGuidesSign inGet API key
API reference

Create a call task

create_call_task (MCP) · POST /api/tasks (REST)

Fields

FieldTypeNotes
phonestring, requiredUS number in any format; normalized to E.164.
goalstring, required3–300 chars. One sentence the caller can act on.
briefstring, required10–4000 chars. See writing briefs.
consentenum, requiredinquiry · express_written · existing_customer · b2b_main_line
state or timezonestring, one required2-letter US state or IANA timezone; drives calling hours.
business_name, lead_namestringShown to the caller.
linksarrayUp to 10 {label, url}.
deadline_minutesint5–10080. Unclaimed tasks expire after this.
webhook_urlurlReceives task.completed.
external_refstringYour 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.