{"templateId":"markdown","versions":[{"version":"1.0","label":"v1.0","link":"/docs/references/1.0/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"1.1","label":"v1.1","link":"/docs/references/1.1/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"1.2","label":"v1.2","link":"/docs/references/1.2/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"1.3","label":"v1.3","link":"/docs/references/1.3/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"1.4","label":"v1.4","link":"/docs/references/1.4/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.0","label":"v2.0","link":"/docs/references/2.0/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.1","label":"v2.1","link":"/docs/references/2.1/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.2","label":"v2.2","link":"/docs/references/2.2/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.3","label":"v2.3","link":"/docs/references/2.3/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.4","label":"v2.4","link":"/docs/references/2.4/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.5","label":"v2.5","link":"/docs/references/2.5/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.6","label":"v2.6","link":"/docs/references/2.6/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.7","label":"v2.7","link":"/docs/references/2.7/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.8","label":"v2.8","link":"/docs/references/2.8/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.9","label":"v2.9","link":"/docs/references/2.9/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.10","label":"v2.10","link":"/docs/references/2.10/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.11","label":"v2.11","link":"/docs/references/2.11/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.12","label":"v2.12","link":"/docs/references/2.12/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.13","label":"v2.13","link":"/docs/references/2.13/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.14","label":"v2.14","link":"/docs/references/2.14/introduction","default":false,"active":false,"folderId":"a015c489"},{"version":"2.15","label":"v2.15","link":"/docs/references/introduction","default":true,"active":false,"folderId":"a015c489"},{"version":"Preview","label":"Preview","link":"/docs/references/preview/introduction","default":false,"active":true,"folderId":"a015c489"}],"sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Preview Introduction","description":"Faster resolutions, higher CSAT, and lighter support volumes with the only platform to combine the power of automation and human customer support.","siteUrl":"https://developers.intercom.com","image":"/assets/og-image.9c9ef3a6cedbceee0e1d52fae2ffcce97f5a189639cf24e473331da9ad02c5f8.b1bff462.png","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"preview-introduction","__idx":0},"children":["Preview Introduction"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Preview version"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Preview API provides early access to new capabilities we're actively developing. It's suitable for production use, and we're continuing to refine it based on customer feedback. While we aim to minimize disruption, some endpoints and fields may evolve. We provide advance notice for breaking changes and maintain compatibility wherever possible. ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/references/preview/changelog"},"children":["Take a look at the Changelog for what's new"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Backwards compatibility"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you were previously using an earlier name for this API version, don't worry — existing version identifiers will continue to work. No changes to your integration are required."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All changes to the Preview version can be viewed in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/references/preview/changelog"},"children":["Changelog"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/build-an-integration/learn-more/rest-apis/unversioned-changes"},"children":["Unversioned changes"]}," for updates released across versions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To change your version see our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/build-an-integration/learn-more/rest-apis/update-your-api-version"},"children":["versioning page"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This API reference is auto-generated from an OpenAPI ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://github.com/intercom/Intercom-OpenAPI"},"children":["specification"]},". It is also interactive, which means you can now make calls to Intercom API directly from the docs."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you'd like to chat with other Intercom customers who are integrating with our API, you can ask a question in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://community.intercom.com/"},"children":["Intercom Community"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information about Intercom products, you can visit our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.intercom.com/help/en/"},"children":["product documentation"]},"."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/AI-Content"},"children":["AI Content"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Admins/admin/"},"children":["Admins"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Articles/article/"},"children":["Articles"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/away-staus-reasons/"},"children":["Away Status Reasons"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/brands"},"children":["Brands"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/calls"},"children":["Calls"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Companies/company/"},"children":["Companies"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Contacts/contact/"},"children":["Contacts"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Conversations/conversation/"},"children":["Conversations"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Data-Attributes/data_attribute/"},"children":["Data Attributes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Data-Connectors"},"children":["Data Connectors"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Data-Events/data_event/"},"children":["Data Events"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Data-Export/data_export/"},"children":["Data Export"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/emails/"},"children":["Emails"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Help-Center/help_center/"},"children":["Help Center"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/internal-articles/internal_article_list_item"},"children":["Internal Articles"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/jobs/jobs/"},"children":["Jobs"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Messages/message/"},"children":["Messages"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/macros/"},"children":["Macros"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/News/news_item/"},"children":["News"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Notes/note/"},"children":["Notes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/reporting-data-export"},"children":["Reporting Data Export"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Segments/segment/"},"children":["Segments"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Subscription-Types/subscription_type/"},"children":["Subscription Types"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Switch/createPhoneSwitch/"},"children":["Switch"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Tags/tag/"},"children":["Tags"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Teams/team/"},"children":["Teams"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Ticket-Type-Attributes/createTicketTypeAttribute/"},"children":["Ticket Type Attributes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Ticket-Types/listTicketTypes/"},"children":["Ticket Types"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/ticket-states/"},"children":["Ticket States"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Tickets/ticket/"},"children":["Tickets"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Visitors/updateVisitor/"},"children":["Visitors"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/Models/activity_log/"},"children":["Models"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/errors/error-codes/"},"children":["Errors"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/whatsapp"},"children":["Whatsapp"]}]}]}]},"headings":[{"value":"Preview Introduction","id":"preview-introduction","depth":1}],"frontmatter":{"seo":{"title":"Preview Introduction"}},"lastModified":"2026-04-10T17:03:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/references/preview/introduction","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}