Account events
account.connected: An account was connected for the first time, or a disconnected or needs-reauth account was reconnected (reason: reconnected); re-authorizing an account that is already connected emits nothing.account.needs_reauth: An account's credentials stopped working and the account must be reconnected.account.disconnected: An account was disconnected because the platform revoked access, the user disconnected it in the dashboard or deleted it through the API (reason: user_disconnected), or its profile was deleted (reason: profile_deleted).
Delivered as a POST to every active endpoint that subscribes to the event and whose profile access covers it. Delivery is at least once and events are not ordered, so deduplicate by id.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Envelope for account.connected, account.needs_reauth, account.disconnected.
Response Body
Example Requests
Envelope for account.connected, account.needs_reauth, account.disconnected.
/accountEventsExternal post events Webhook
- `post.external.created`: External post sync found a post published directly on the platform; posts published before the account was connected and posts found by the account's first discovery run (history import) do not emit it. Delivered as a `POST` to every active endpoint that subscribes to the event and whose profile access covers it. Delivery is at least once and events are not ordered, so deduplicate by `id`.
Analytics events Webhook
- `analytics.synced`: An account's metrics sync completed; `postsSynced` counts the posts whose metrics were refreshed. Delivered as a `POST` to every active endpoint that subscribes to the event and whose profile access covers it. Delivery is at least once and events are not ordered, so deduplicate by `id`.