The intercom API reference.
The intercom API reference.
Collections are top level containers for Articles within the Help Center.
The name of the collection. For multilingual collections, this will be the name of the default language's content.
The description of the collection. For multilingual help centers, this will be the description of the collection for the default language.
The time when the article was created (seconds). For multilingual articles, this will be the timestamp of creation of the default language's content.
The time when the article was last updated (seconds). For multilingual articles, this will be the timestamp of last update of the default language's content.
The URL of the collection. For multilingual help centers, this will be the URL of the collection for the default language.
The order of the section in relation to others sections within a collection. Values go from 0
upwards. 0
is the default if there's no order.
The default locale of the help center. This field is only returned for multilingual help centers.
The Translated Content of an Group. The keys are the locale codes and the values are the translated content of the Group.
{ "id": "6871119", "workspace_id": "hfi1bx4l", "name": "Default language name", "description": "Default language description", "created_at": 1672928359, "updated_at": 1672928610, "url": "http://intercom.test/help/collection/name", "icon": "book-bookmark", "order": "1", "default_locale": "en", "translated_content": { "type": "group_translated_content", "ar": { … }, "bg": { … }, "bs": { … }, "ca": { … }, "cs": { … }, "da": { … }, "de": { … }, "el": { … }, "en": { … }, "es": { … }, "et": { … }, "fi": { … }, "fr": { … }, "he": { … }, "hr": { … }, "hu": { … }, "id": { … }, "it": { … }, "ja": { … }, "ko": { … }, "lt": { … }, "lv": { … }, "mn": { … }, "nb": { … }, "nl": { … }, "pl": { … }, "pt": { … }, "ro": { … }, "ru": { … }, "sl": { … }, "sr": { … }, "sv": { … }, "tr": { … }, "vi": { … }, "pt-BR": { … }, "zh-CN": { … }, "zh-TW": { … } }, "help_center_id": "123", "type": "collection" }
Help Centers contain collections
The identifier of the Help Center. This is used in the URL of the Help Center.
Whether the Help Center is turned on or not. This is controlled in your Help Center settings.
{ "id": "123", "workspace_id": "hfi1bx4l", "created_at": 1672928359, "updated_at": 1672928610, "identifier": "intercom", "website_turned_on": true, "display_name": "Intercom Help Center" }
Sections are subdivisions of a collection, with a collection potentially having multiple sections.
The name of the section. For multilingual sections, this will be the name of the default language's content.
The time when the section was created. For multilingual sections, this will be the timestamp of creation of the default language's content.
The time when the section was last updated. For multilingual sections, this will be the timestamp of last update of the default language's content.
The URL of the section. For multilingual help centers, this will be the URL of the section for the default language.
The order of the section in relation to others sections within a collection. Values go from 0
upwards. 0
is the default if there's no order.
The id of the parent section.
The id of the parent section.
The id of the parent section.
The default locale of the help center. This field is only returned for multilingual help centers.
{ "type": "section", "id": "6871119", "workspace_id": "hfi1bx4l", "name": "Default language name", "created_at": 1672928359, "updated_at": 1672928610, "url": "http://intercom.test/help/section/name", "icon": "book-bookmark", "order": "1", "parent_id": 6871119, "default_locale": "en", "translated_content": { "type": "group_translated_content", "ar": { … }, "bg": { … }, "bs": { … }, "ca": { … }, "cs": { … }, "da": { … }, "de": { … }, "el": { … }, "en": { … }, "es": { … }, "et": { … }, "fi": { … }, "fr": { … }, "he": { … }, "hr": { … }, "hu": { … }, "id": { … }, "it": { … }, "ja": { … }, "ko": { … }, "lt": { … }, "lv": { … }, "mn": { … }, "nb": { … }, "nl": { … }, "pl": { … }, "pt": { … }, "ro": { … }, "ru": { … }, "sl": { … }, "sr": { … }, "sv": { … }, "tr": { … }, "vi": { … }, "pt-BR": { … }, "zh-CN": { … }, "zh-TW": { … } } }
You can fetch a list of all collections by making a GET request to https://api.intercom.io/help_center/collections
.
Collections will be returned in descending order on the updated_at
attribute. This means if you need to iterate through results then we'll show the most recently updated collections first.
curl -i -X GET \ https://api.intercom.io/help_center/collections \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Intercom-Version: 2.8'
{ "type": "list", "data": [ { … } ], "total_count": 1, "pages": { "type": "pages", "page": 1, "per_page": 20, "total_pages": 1 } }
The name of the collection. For multilingual collections, this will be the name of the default language's content.
The description of the collection. For multilingual collections, this will be the description of the default language's content.
The Translated Content of an Group. The keys are the locale codes and the values are the translated content of the Group.
curl -i -X POST \ https://api.intercom.io/help_center/collections \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -H 'Intercom-Version: 2.8' \ -d '{ "name": "Thanks for everything" }'
collection created
The name of the collection. For multilingual collections, this will be the name of the default language's content.
The description of the collection. For multilingual help centers, this will be the description of the collection for the default language.
The time when the article was created (seconds). For multilingual articles, this will be the timestamp of creation of the default language's content.
The time when the article was last updated (seconds). For multilingual articles, this will be the timestamp of last update of the default language's content.
The URL of the collection. For multilingual help centers, this will be the URL of the collection for the default language.
The order of the section in relation to others sections within a collection. Values go from 0
upwards. 0
is the default if there's no order.
The default locale of the help center. This field is only returned for multilingual help centers.
The Translated Content of an Group. The keys are the locale codes and the values are the translated content of the Group.
{ "id": "95", "workspace_id": "this_is_an_id67_that_should_be_at_least_4", "name": "Thanks for everything", "url": "http://help-center.test/myapp-67/", "order": 1, "created_at": 1717021004, "updated_at": 1717021004, "description": "", "icon": "book-bookmark", "help_center_id": 55, "type": "collection" }
curl -i -X GET \ 'https://api.intercom.io/help_center/collections/{id}' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Intercom-Version: 2.8'
Collection found
The name of the collection. For multilingual collections, this will be the name of the default language's content.
The description of the collection. For multilingual help centers, this will be the description of the collection for the default language.
The time when the article was created (seconds). For multilingual articles, this will be the timestamp of creation of the default language's content.
The time when the article was last updated (seconds). For multilingual articles, this will be the timestamp of last update of the default language's content.
The URL of the collection. For multilingual help centers, this will be the URL of the collection for the default language.
The order of the section in relation to others sections within a collection. Values go from 0
upwards. 0
is the default if there's no order.
The default locale of the help center. This field is only returned for multilingual help centers.
The Translated Content of an Group. The keys are the locale codes and the values are the translated content of the Group.
{ "id": "100", "workspace_id": "this_is_an_id73_that_should_be_at_least_4", "name": "English collection title", "url": "http://help-center.test/myapp-73/collection-22", "order": 22, "created_at": 1717021005, "updated_at": 1717021005, "description": "english collection description", "icon": "bookmark", "help_center_id": 58, "type": "collection" }
The name of the collection. For multilingual collections, this will be the name of the default language's content.
The description of the collection. For multilingual collections, this will be the description of the default language's content.
curl -i -X PUT \ 'https://api.intercom.io/help_center/collections/{id}' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -H 'Intercom-Version: 2.8' \ -d '{ "name": "Update collection name" }'
successful
The name of the collection. For multilingual collections, this will be the name of the default language's content.
The description of the collection. For multilingual help centers, this will be the description of the collection for the default language.
The time when the article was created (seconds). For multilingual articles, this will be the timestamp of creation of the default language's content.
The time when the article was last updated (seconds). For multilingual articles, this will be the timestamp of last update of the default language's content.
The URL of the collection. For multilingual help centers, this will be the URL of the collection for the default language.
The order of the section in relation to others sections within a collection. Values go from 0
upwards. 0
is the default if there's no order.
The default locale of the help center. This field is only returned for multilingual help centers.
The Translated Content of an Group. The keys are the locale codes and the values are the translated content of the Group.
{ "id": "106", "workspace_id": "this_is_an_id79_that_should_be_at_least_4", "name": "Update collection name", "url": "http://help-center.test/myapp-79/collection-25", "order": 25, "created_at": 1717021007, "updated_at": 1717021007, "description": "english collection description", "icon": "folder", "help_center_id": 61, "type": "collection" }
curl -i -X DELETE \ 'https://api.intercom.io/help_center/collections/{id}' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Intercom-Version: 2.8'
{ "id": "112", "object": "collection", "deleted": true }
curl -i -X GET \ 'https://api.intercom.io/help_center/help_centers/{id}' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Intercom-Version: 2.8'
{ "id": "67", "workspace_id": "this_is_an_id91_that_should_be_at_least_4", "created_at": 1717021010, "updated_at": 1717021010, "identifier": "help-center-1", "website_turned_on": false, "display_name": "Intercom Help Center" }
curl -i -X GET \ https://api.intercom.io/help_center/help_centers \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Intercom-Version: 2.8'
{ "type": "list", "data": [] }
You can fetch a list of all sections by making a GET request to https://api.intercom.io/help_center/sections
.
📘 How are the sections sorted and ordered?
Sections will be returned in descending order on the
updated_at
attribute. This means if you need to iterate through results then we'll show the most recently updated sections first.
curl -i -X GET \ https://api.intercom.io/help_center/sections \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Intercom-Version: 2.8'
{ "type": "list", "data": [ { … } ], "total_count": 1, "pages": { "type": "pages", "page": 1, "per_page": 20, "total_pages": 1 } }
The name of the collection. For multilingual collections, this will be the name of the default language's content.
curl -i -X POST \ https://api.intercom.io/help_center/sections \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -H 'Intercom-Version: 2.8' \ -d '{ "name": "Thanks for everything", "parent_id": 122 }'
section created
The name of the section. For multilingual sections, this will be the name of the default language's content.
The time when the section was created. For multilingual sections, this will be the timestamp of creation of the default language's content.
The time when the section was last updated. For multilingual sections, this will be the timestamp of last update of the default language's content.
The URL of the section. For multilingual help centers, this will be the URL of the section for the default language.
The order of the section in relation to others sections within a collection. Values go from 0
upwards. 0
is the default if there's no order.
The id of the parent section.
The id of the parent section.
The id of the parent section.
The default locale of the help center. This field is only returned for multilingual help centers.
{ "id": "124", "workspace_id": "this_is_an_id105_that_should_be_at_least_", "name": "Thanks for everything", "url": "http://help-center.test/myapp-105/", "order": 1, "created_at": 1717021014, "updated_at": 1717021014, "type": "section", "parent_id": "122" }
curl -i -X GET \ 'https://api.intercom.io/help_center/sections/{id}' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Intercom-Version: 2.8'
Section found
The name of the section. For multilingual sections, this will be the name of the default language's content.
The time when the section was created. For multilingual sections, this will be the timestamp of creation of the default language's content.
The time when the section was last updated. For multilingual sections, this will be the timestamp of last update of the default language's content.
The URL of the section. For multilingual help centers, this will be the URL of the section for the default language.
The order of the section in relation to others sections within a collection. Values go from 0
upwards. 0
is the default if there's no order.
The id of the parent section.
The id of the parent section.
The id of the parent section.
The default locale of the help center. This field is only returned for multilingual help centers.
{ "id": "128", "workspace_id": "this_is_an_id109_that_should_be_at_least_", "name": "English section title", "url": "http://help-center.test/myapp-109/section-19", "order": 19, "created_at": 1717021014, "updated_at": 1717021014, "type": "section", "parent_id": 127 }
The name of the collection. For multilingual collections, this will be the name of the default language's content.
curl -i -X PUT \ 'https://api.intercom.io/help_center/sections/{id}' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -H 'Intercom-Version: 2.8' \ -d '{ "name": "Update section name", "parent_id": 133 }'
successful
The name of the section. For multilingual sections, this will be the name of the default language's content.
The time when the section was created. For multilingual sections, this will be the timestamp of creation of the default language's content.
The time when the section was last updated. For multilingual sections, this will be the timestamp of last update of the default language's content.
The URL of the section. For multilingual help centers, this will be the URL of the section for the default language.
The order of the section in relation to others sections within a collection. Values go from 0
upwards. 0
is the default if there's no order.
The id of the parent section.
The id of the parent section.
The id of the parent section.
The default locale of the help center. This field is only returned for multilingual help centers.
{ "id": "134", "workspace_id": "this_is_an_id115_that_should_be_at_least_", "name": "Update section name", "url": "http://help-center.test/myapp-115/section-22", "order": 22, "created_at": 1717021016, "updated_at": 1717021016, "type": "section", "parent_id": "133" }
curl -i -X DELETE \ 'https://api.intercom.io/help_center/sections/{id}' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Intercom-Version: 2.8'
{ "id": "140", "object": "section", "deleted": true }