Skip to content
SynupAPI
Get an API key
EVENTsocial_post.published

Social post published

Event name: social_post.published

A social post was published to its 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.published_onstringoptionalPublish time, ISO-8601.
data.itemsarray of objectoptionalPer-platform results: platform, social_platform_id, connected_account_id, published_url, vendor_post_id, status.
Example delivery
{
  "event": "social_post.published",
  "timestamp": "2026-07-15T12:00:05Z",
  "account_id": 11073,
  "location_id": null,
  "data": {
    "post_id": "7a1c...",
    "social_profile_id": "b2d4...",
    "status": "published",
    "published_on": "2026-07-15T12:00:00Z",
    "items": [
      {
        "platform": "facebook",
        "social_platform_id": "f-123",
        "connected_account_id": "c-9",
        "published_url": "https://facebook.com/p/xyz",
        "vendor_post_id": "vp_88",
        "status": "published"
      }
    ]
  }
}