REST APIs

Our REST API is a core building block of the Intercom Platform. You can use it to retrieve and update information from your own Intercom account, or to integrate Intercom into your own product. It's completely up to you and your custom use case.

Available Endpoints

📘

API Endpoints for Regional Data Hosting Customers

For customers who are using Regional Data Hosting, the base URI for the API Endpoints are listed below. This replaces the start of the URIs for each REST API endpoint, to connect to the specific regions.

Regional Hosting LocationREST Endpoint to use
UShttps://api.intercom.io/
Europehttps://api.eu.intercom.io
Australiahttps://api.au.intercom.io

The API is organized around the following resources:

API AreaResource AreaDescription
Contactshttps://api.intercom.io/contactsFetch, search, create, update and delete your contacts (users or leads).
Visitorshttps://api.intercom.io/visitorsView, update and convert anonymous visitors on a website.
Companieshttps://api.intercom.io/companiesCreate and update Companies. List companies or access them individually.
Data Attributeshttps://api.intercom.io/data_attributesList attributes used to describe your customer and company models.
Tagshttps://api.intercom.io/tagsOrganise Users and your workspace Admins with tags.
Segmentshttps://api.intercom.io/segmentsView your workspace's Segments.
Noteshttps://api.intercom.io/notesCreate and view notes about Users.
Eventshttps://api.intercom.io/eventsUse Events to submit User activity to Intercom
Countshttps://api.intercom.io/countsCounts of Users and Companies by segment and tag. View open and closed counts for Admins.
Conversationshttps://api.intercom.io/conversationsList conversations you have with users on your system. Allow Users and Admins to send messages and reply to conversations.
Messageshttps://api.intercom.io/messagesCreate and view Messages.
Adminshttps://api.intercom.io/adminsView your workspace's teammates.
Teamshttps://api.intercom.io/teamsView your workspace's teams.
Articleshttps://api.intercom.io/articlesCreate, retrieve, update, and delete articles.
Help Centerhttps://api.intercom.io/help_centerCreate, retrieve, update, and delete Collections and Sections.

Common Approaches

The API uses common approaches for the following:

FunctionDescription
DataAPI data is JSON encoded with UTF-8. API JSON is either a single object or a list of objects.
Errors4xx and 5xx responses returning JSON with error codes.
Rate LimitingControls how many requests can be made in a time window.
HTTPMethods are used in accordance with HTTP (GET POST and DELETE are the primary methods used) and resources are identified using URIs. All API requests are sent over HTTPS.