For changes that have been updated across all version, see the Unversioned changes page.
We introduced webhook topic support for all Outbound Message events across all content types in Intercom, such as Emails, Custom Bots, Surveys, and more.
We added new webhooks that fire when an Admin logs into a workspace (through email/password, Google SSO, or SAML SSO) or logs out of a workspace (either through a manual logout or through session expiry if signed in with SAML SSO).
We added several new webhook topics for Contact events: updated (User), merged (User & Lead), deleted (User & Lead), archived (User & Lead), unarchived (User & Lead).
We added new webhooks that fire when a contact is attached to a conversation or detached from a conversation.
We added a new webhook topic that fires when a user subscribes to a specific subscription type.
We added new webhooks that fire when a contact is attached to a company or detached from a company.
The Create Conversation endpoint now expects lead and user in request payload. Previously this endpoint accepted values of contact and user.
The list conversations endpoint now uses cursor based pagination instead of traditional pagination.
The Conversation Part Type model now contains significantly more part types. Older API versions would log some part types simply as comment, now there is a lot more granularity.
Conversation Source object now differentiates admin-created tickets and conversations now appear as admin_initiated to distinguish them from automation. More details about the different possible values have been exposed.
The Delete Contact endpoint now allows permanent deletion of archived contacts directly. Previously, when attempting to delete an archived contact via the API, the contact needed to be unarchived and then deleted. This is no longer necessary.
We added a new field to the Contact model, that will show all the subscriptions that a contact has opted into.