API changes

We take the utmost care to ensure that changes to our APIs do not break your integrations. We consider the following changes to be backward-compatible:

• Adding new, optional request fields/parameters to existing APIs
• Adding new fields to existing API responses
• Adding new, optional HTTP request headers
• Adding new HTTP response headers
• Increasing the length of existing string field values
• Changing the format of identifiers, including changing or removing prefixes
• Adding new webhook event types – You must explicitly subscribe to webhooks to receive them.
• Adding new fields to existing webhook event schemas

If a breaking change is unavoidable (for example, for compliance reasons), we contact you in advance to ensure you have sufficient time to update your integration.