The intercom API reference.
URL https://developers.intercom.com
License MIT
The intercom API reference.
With the AI Content APIs, you can create and manage External Pages and Content Import Sources for your Fin Content Library.
Â
External Pages are pages that you want Fin to be able to answer questions about. The API for External Pages is a great way to ingest into your Fin Content Library pages that are not publicly accessible and hence can't be crawled by Intercom.
Â
Content Import Sources are the sources of those pages, and they are used to determine the default audience for the pages (configured via the UI). You should create a Content Import Source for each source of External Pages that you want to ingest into your Fin Content Library.
Â
You can then iterate through the content from that source via its API and POST it to the External Pages endpoint. That endpoint has an external_id parameter which allows you to specify the identifier from the source. The endpoint will then either create a new External Page or update an existing one as appropriate.",
Notes allow you to annotate and comment on your contacts.
{ "type": "note", "id": "17495962", "created_at": 1674589321, "contact": { "type": "string", "id": "214656d0c743eafcfde7f248" }, "author": { "type": "admin", "id": "1295", "name": "Joe Example", "email": "jdoe@example.com", "job_title": "Associate", "away_mode_enabled": false, "away_mode_reassign": false, "has_inbox_seat": true, "team_ids": [ … ], "avatar": "https://picsum.photos/200/300", "team_priority_level": { … } }, "body": "<p>Text for the note.</p>" }
curl -i -X GET \
'https://api.intercom.io/contacts/{id}/notes' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Intercom-Version: Unstable'Successful response
Cursor-based pagination is a technique used in the Intercom API to navigate through large amounts of data. A "cursor" or pointer is used to keep track of the current position in the result set, allowing the API to return the data in small chunks or "pages" as needed.
{ "type": "list", "data": [ { … }, { … }, { … } ], "total_count": 3, "pages": { "type": "pages", "next": null, "page": 1, "per_page": 50, "total_pages": 1 } }
curl -i -X POST \
'https://api.intercom.io/contacts/{id}/notes' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-H 'Intercom-Version: Unstable' \
-d '{
"contact_id": "67506132d5eefd6f04e7d08e",
"admin_id": 991267584,
"body": "Hello"
}'{ "type": "note", "id": "34", "created_at": 1733321010, "contact": { "type": "contact", "id": "67506132d5eefd6f04e7d08e" }, "author": { "type": "admin", "id": "991267584", "name": "Ciaran124 Lee", "email": "admin124@email.com", "away_mode_enabled": false, "away_mode_reassign": false }, "body": "<p>Hello</p>" }
curl -i -X GET \
'https://api.intercom.io/notes/{id}' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Intercom-Version: Unstable'{ "type": "note", "id": "37", "created_at": 1732630192, "contact": { "type": "contact", "id": "675062b0d5eefd6f04e7d14a" }, "author": { "type": "admin", "id": "991267857", "name": "Ciaran339 Lee", "email": "admin339@email.com", "away_mode_enabled": false, "away_mode_reassign": false }, "body": "<p>This is a note.</p>" }