Changelog

While v1 is pre-release, the shape can still change. That is what the pre-release banner means. Every change is recorded here, so you can see exactly what moved and decide whether it affects your integration.

2026-09-14: v1 published

First public version of the contract. Everything below is the initial commitment.

Endpoints: robots, channels, automation rules, media, usage, and a read-only webhook configuration endpoint.

Webhook events: message, message.generating, chat, reaction, is_typing.

Decisions worth calling out, because each one changes what you build:

DecisionWhy
No writable webhook endpointA stolen key must not be able to redirect your event stream
Webhook auth token is yours to setIt only gates your own endpoint, so waiting on us would be friction
Rate limit queues, never dropsA dropped automated reply is a lost customer conversation
context_reset is not deletionTreating it as deletion discards a transcript we still hold
follows_business: null fails opennull is “Meta did not confirm”, not “does not follow”
404, not 403, for others’ resourcesA 403 would confirm the id exists

How changes are announced

ChangeYou hear about it via
A new field, event, or endpointThis page. Not breaking, so ignore what you do not recognise
A removed or renamed fieldYour account manager, in advance
A route going liveThe pre-release banner disappears from that page

See Versioning & stability for the full rules on what counts as breaking.