v1

latestOpenAPI 3.0.12026-07-22120163333.7 KB
Lead Activity V2 API

List lead activities

Returns a unified list of call, text and email activities for the given lead, including both auto-captured and agent-logged entries, sorted by activityTime ascending.

Notes:

  • Caller must have access to the lead; otherwise 404 LEAD_NOT_EXIST.
  • Use currentId for cursor-based pagination or offset for offset-based pagination.
get/v2.0/leads/{leadId}/activities

Path parameters

leadIdinteger required

ID of the lead whose activities to return.

Query parameters

currentIdinteger

Cursor-based pagination anchor. Pass the last returned item's id to fetch the next page. Default 0 (start from beginning).

Cursor-based pagination anchor. Pass the last returned item's id to fetch the next page. Default 0 (start from beginning).

offsetinteger

Offset for offset-based pagination. Ignored when currentId > 0. Default 0.

Offset for offset-based pagination. Ignored when currentId > 0. Default 0.

limitinteger

Page size, 1–1000. Default 10.

Page size, 1–1000. Default 10.

timeZoneCodestring nullable

Timezone in IANA format (e.g. America/Los_Angeles). Affects activityTime formatting. Defaults to user configured timezone if not provided.

Timezone in IANA format (e.g. America/Los_Angeles). Affects activityTime formatting. Defaults to user configured timezone if not provided.

Headers

Authorizationstring required

Bearer [access_token]

Response

Unified activity entries for the lead.

Example response

{
  "activities": [
    {
      "activityTime": "2026-03-19T10:30:00-07:00"
    }
  ]
}