Analytics events
analytics.synced: An account's metrics sync completed;postsSyncedcounts 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.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Envelope for analytics.synced.
Response Body
Example Requests
Envelope for analytics.synced.
/analyticsEventsAccount events Webhook
- `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`.
Conversation events Webhook
- `conversation.started`: A new direct-message conversation appeared on a connected account; conversations imported by the account's first inbox sync 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`.