Call tasks
POST
/call-tasks/{id}/complete

Log the call: how it went and an optional note. The lead moves on to its next step at once, as when the call is logged in the app. An unknown id is a 400 with code: warning-call-task-not-found, and a task that is no longer pending a 400 with code: warning-call-task-decided. A task whose lead already left the step on its own is closed, and returns a 400 with code: warning-call-task-stale. A task decided elsewhere at the same moment (in the app, or by another call) is a 400 with code: warning-call-task-raced: the first decision stands.

Authorization

bearerAuth
AuthorizationBearer <token>

An API key created on the Access tokens page.

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/call-tasks/string/complete" \  -H "Content-Type: application/json" \  -d '{    "outcome": "reached",    "note": "Interested; wants a demo next Tuesday."  }'
{  "data": {    "id": "string",    "status": "pending",    "lead": {      "id": "string",      "name": "string",      "profileUrl": "string",      "phone": "string",      "email": "string"    },    "campaign": {      "id": "string",      "name": "string"    },    "stepId": "string",    "instructions": "string",    "dueAt": "2019-08-24T14:15:22Z",    "createdAt": "2019-08-24T14:15:22Z",    "outcome": "reached",    "note": "string",    "decidedAt": "2019-08-24T14:15:22Z",    "closedReason": "string"  }}