Intercom API (unofficial showcase)
GET/contacts/activities

List contact activities

Lists contact activity events for the workspace, including contact creation, role updates, merges, and deletions. Results are ordered from oldest to newest. Use starting_after to continue from a previous page and per_page to control the page size, from 1 to 150.

3 parameters
per_pageintegeroptional
The number of results per page, from 1 to 150. Defaults to 50 when omitted.
Default:50
starting_afterstringoptional
The cursor from `pages.next.starting_after` in a previous response, used to fetch the next page.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

2 status codes
200Returns a paginated list of contact activity objects and pagination details; events are ordered oldest first.
typestringoptional
Always list
Allowed:list
dataarray<ContactActivity>optional
The list of contact activity objects.
pagesobjectoptional
Pagination information.
401Returned when the request is unauthorized.

One documented failure

  • unauthorized

    Access Token Invalid

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 401 is returned when the request is unauthorized. per_page must be between 1 and 150; it defaults to 50 when omitted. Use a starting_after cursor from pages.next.starting_after to continue pagination.