List all contacts

Example Request & Response

$ curl https://api.intercom.io/contacts \\\n-H 'Authorization:Bearer <Your access token>' \\\n-H 'Accept:application/json'

Example Errors

Invalid starting_after param

HTTP/1.1 400 BAD REQUEST\n{\n  \"type\": \"error.list\",\n  \"request_id\": \"000nbboasf1qqab6b910\",\n  \"errors\": [\n    {\n      \"code\": \"client_error\",\n      \"message\": \"Invalid starting_after param. Please try again using a starting_after value from a paginated response\"\n    }\n  ]\n}\n

You can fetch a list of all contacts.

Response

This will return a paginated list of Contact objects.

AttributeTypeDescription
typeStringThe type of object - list
dataArrayAn array containing Contact Objects
total_countIntegerThe total number of contacts
pagesPagination ObjectThe information needed to paginate through contacts