New integrations must use version 2 (v2) of the API.

The version of the API is denoted in the URL for all API endpoints. E.g.:


We are committed to continuously improving the API. Non-breaking changes might be made without releasing a new version of the API. Such changes can include:

  • Adding new resources
  • Adding new optional request parameters to existing resources
  • Adding new attributes to existing responses
  • Changing error message payloads (usually to make them more descriptive)