provider Contacts GET
/contacts @utdk/intercom
/contacts List all contacts
You can fetch a list of all contacts (ie. users or leads) in your workspace.
{% admonition type="info" name="Merged contacts" %}
Contacts that have been merged (via POST /contacts/merge) will not appear in list results. Only the target contact from the merge remains accessible.
{% /admonition %}
{% admonition type="warning" name="Pagination" %}
You can use pagination to limit the number of results returned. The default is `50` results per page.
See the [pagination section](https://developers.intercom.com/docs/build-an-integration/learn-more/rest-apis/pagination/#pagination-for-list-apis) for more details on how to use the `starting_after` param.
{% /admonition %}
- Intercom-Version header
- enum: 1.0, 1.1, 1.2, 1.3…
Try it
Authentication
Configure credentials for Intercom API
Gateway
The gateway proxies requests and injects credentials server-side. Configure credentials above, then enter your gateway URL.
Saved automatically to browser storage.
Code snippet
Updates live as you fill in the form above.
TypeScript
import intercom from '@utdk/intercom';
await intercom.listcontacts({
"Intercom-Version": "2.14"
})