About the API Changelogs

Below you can find links to changelogs that detail changes to the API from each version. You can also see our definition of a breaking change.

To access new features, you'll need to change your API version in the Developer Hub or set a version in the header of your API call.

Changelogs

ChangelogRelease dateDocs
Unversioned changesOngoingReference
UnstableOngoingReference
2.102023-09-14Reference
2.92023-01-24Reference
2.82023-01-24Reference
2.72022-12-07Reference
2.62022-10-18Reference
2.52022-06-07Reference
2.42021-12-13Reference
2.32020-11-12Reference
2.22020-08-12Reference
2.12020-07-14Reference
2.02020-01-30Reference
1.42019-09-26Reference
1.32019-06-05Reference
1.22019-05-03Reference
1.12018-10-16Reference
1.02018-10-15Reference

About breaking changes in the Intercom API

The Intercom API is a versioned API. The version number increments by 0.1 each release, unless we introduce major new functionality, in which case we will increment by 1. We do not follow Semantic Versioning.

Any breaking changes will be released in a new API version. Breaking changes are changes that can potentially break an integration. Breaking changes can include:

  • removing an entire operation
  • removing or renaming a parameter
  • removing or renaming a response field
  • adding a new required parameter
  • making a previously optional parameter required
  • changing the type of a parameter or response field
  • removing enum values
  • adding a new validation rule to an existing parameter
  • changing authentication or authorization requirements