EVENTsocial_connection.ad_account_status_changed

Ad account status changed

Event name: social_connection.ad_account_status_changed

A connected ad account's status changed. Scope: brand-scoped (location_id is null). Delivered as a signed HTTP POST to your Webhooks URL.

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

Payload

Name	Type	Required	Description
`event`	string	optional	Dotted event name.
`timestamp`	string	optional	ISO-8601 UTC time the event was emitted.
`account_id`	integer	optional	Synup account the event belongs to.
`location_id`	string	optional	Numeric string for location-scoped events; null for brand-scoped events.
`data`	object	optional
`data.ad_account_id`	string	optional	Ad account UUID.
`data.previous_status`	string	optional	Prior status.
`data.current_status`	string	optional	New status.
`data.platform`	string	optional	Ad platform.
`data.error_reason`	string	optional	Error detail when the new status is an error state.

Example delivery

{
  "event": "social_connection.ad_account_status_changed",
  "timestamp": "2026-07-15T10:30:00Z",
  "account_id": 11073,
  "location_id": null,
  "data": {
    "ad_account_id": "ad-77",
    "previous_status": "active",
    "current_status": "disabled",
    "platform": "facebook",
    "error_reason": "Payment method failed"
  }
}