Account Webhooks
React when accounts are connected, disconnected, expired, or revoked.
Account events track the connection lifecycle of your social accounts. Every delivery uses the shared envelope described in Webhooks.
Events
| Event | When |
|---|---|
account.connected | Account connected or reconnected |
account.disconnected | Account removed |
account.expired | Access token expired and refresh failed |
account.revoked | Platform rejected the token (user revoked access) |
Payloads
account.connected:
{
"accountId": "ACCOUNT_ID",
"platform": "facebook",
"handle": "acme",
"displayName": "Acme Inc",
"status": "active"
}account.disconnected carries accountId, platform, and handle.
account.expired and account.revoked share this shape (status and reason differ per event):
{
"accountId": "ACCOUNT_ID",
"platform": "instagram",
"handle": "acme",
"status": "expired",
"reason": "refresh_failed",
"tokenExpiresAt": "2026-07-14T12:00:00.000Z",
"previousStatus": "active"
}For expired connections reason is "expired" or "refresh_failed"; for revoked ones "refresh_revoked" or "token_invalid".
Subscribe to both events so you can prompt users to reconnect before publishing starts failing.