v1

latestOpenAPI 3.0.12026-07-22120163333.7 KB

Tasks & Appointments

List Tasks (V1)

Returns tasks attached to the given lead. Caller must have manage permission on the lead.

get/v1.0/tasks

Query parameters

leadIdinteger required

ID of the lead whose tasks to return.

Headers

Authorizationstring required

Bearer [access_token]

Response

Tasks for the lead.

Example response

{
  "taskList": [
    {
      "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
    }
  ]
}