Skip to content
SynupAPI
Get an API key
EVENTsocial_post.failed

Social post failed

Event name: social_post.failed

A social post failed to publish on one or more platforms. 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

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.post_idstringoptionalSocial post UUID.
data.social_profile_idstringoptionalBrand UUID.
data.statusstringoptionalPost status.
data.itemsarray of objectoptionalPer-platform failure detail: platform, social_platform_id, status, reason, vendor_error.
Example delivery
{
  "event": "social_post.failed",
  "timestamp": "2026-07-15T12:00:10Z",
  "account_id": 11073,
  "location_id": null,
  "data": {
    "post_id": "7a1c...",
    "social_profile_id": "b2d4...",
    "status": "failed",
    "items": [
      {
        "platform": "instagram",
        "social_platform_id": "i-55",
        "status": "failed",
        "reason": "Media rejected by platform",
        "vendor_error": "IG_MEDIA_ERROR"
      }
    ]
  }
}