v1

latestOpenAPI 3.0.12026-07-22120163333.7 KB

Tasks & Appointments

Get Task (V1)

Returns a single task by ID, along with the lead's pipeline context. Caller must have manage permission on the lead that owns the task.

get/v1.0/tasks/{taskId}

Path parameters

taskIdinteger required

ID of the task to retrieve.

Headers

Authorizationstring required

Bearer [access_token]

Response

Task retrieved successfully.

Example response

{
  "task": {
    "id": 563172647619608,
    "leadId": 100001,
    "creatorId": 100234,
    "content": "Send an email to my lead",
    "type": "Call",
    "deadline": "2026-04-22 17:00:00",
    "finishTime": "2026-04-22 16:30:00",
    "createTime": "2026-04-20 09:00:00",
    "lastUpdate": "2026-04-20 09:00:00",
    "leadName": "Alice Johnson",
    "leadEmail": "alice@example.com",
    "leadPhone": "+14155550199",
    "leadFirstName": "Alice",
    "leadLastName": "Johnson",
    "assignedRole": "Agent",
    "assignedUser": "Alice Johnson",
    "teamId": 12345,
    "subject": "Follow-up on Austin listings",
    "body": "Discussed Austin inventory last week; sending the pre-approval doc now.",
    "assignedUserId": 100234,
    "pipelineId": 12345,
    "leadUserId": 100001
  }
}