List all contact activities

Request

You can fetch a list of contact activity events for your workspace, such as when contacts are created, role updated, merged, or deleted. Events are returned oldest first.

Pagination

You can use pagination to limit the number of results returned. The default is 50 results per page, with a maximum of 150. See the pagination section for more details on how to use the starting_after param.

Security

bearerAuth

Query

per_pageinteger, [ 1 .. 150 ]

The number of results to return per page. Defaults to 50, minimum 1, maximum 150.

Default:50

starting_afterstring

The cursor value from pages.next.starting_after in a previous response. Used to paginate through results.

Intercom-Versionstring(intercom_version)

Intercom API version.
By default, it's equal to the version set in the app package.

Default:"Preview"

Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"

Example:Preview

curl -i -X GET \
  'https://api.intercom.io/contacts/activities?per_page=50&starting_after=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: Preview'

Responses

successful

Bodyapplication/json

typestring

Always list

Value:"list"

Example:"list"

dataArray of objects(Contact Activity)

The list of contact activity objects.

pagesobject

Pagination information.

Response

{
  "type": "list",
  "data": [
    { … },
    { … },
    { … },
    { … },
    { … }
  ],
  "pages": {
    "type": "pages",
    "per_page": 50,
    "next": { … }
  }
}