Skip to content
SynupAPI
Get an API key
EVENTconnection.reauth_required

Listing re-authorization required

Event name: connection.reauth_required

The connected account's credentials were invalidated; the customer must reconnect / re-authorize. Scope: location-scoped. Delivered as a signed HTTP POST to your Webhooks URL.

Every delivery is signed. Verify X-Synup-Signature before processing — see Synup Webhooks.

Payload

NameTypeRequiredDescription
eventstringoptionalDotted event name.
timestampstringoptionalISO-8601 UTC time the event was emitted.
account_idintegeroptionalSynup account the event belongs to.
location_idstringoptionalNumeric string for location-scoped events; null for brand-scoped events.
dataobjectoptional
data.platformstringoptional"google" or "facebook".
data.connected_account_idstringoptionalUUID of the connected account needing re-auth.
data.reasonstringoptionalHuman-readable description of the issue.
Example delivery
{
  "event": "connection.reauth_required",
  "timestamp": "2026-07-15T14:40:18Z",
  "account_id": 11073,
  "location_id": "279381",
  "data": {
    "platform": "google",
    "connected_account_id": "ba03bc4b-9f8c-4d3b-8e93-9628034c63cc",
    "reason": "The Google account credentials are no longer valid. Please reconnect."
  }
}