EVENTlisting.submission

Directory listing synced (success/incomplete)

Event name: listing.submission

Sent when Synup finishes attempting to sync a business listing to a directory (Google, Facebook, etc.), triggered by profile updates or new directory submissions. Delivered to your Webhooks URL (Listings webhook). One delivery per status change — a move from incomplete to success sends two separate calls. Note the compact envelope: there is no top-level timestamp or account_id, and the location is identified by the Base64 id inside data.

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

Payload

Name	Type	Required	Description
`event`	string	optional	Always "listing.submission".
`status`	string	optional	"success" (listing is live on the directory) or "incomplete" (could not be completed).
`live_link`	string	optional	Public URL of the live listing. Present only when status is "success".
`error_message`	string	optional	Why the submission could not be completed. Present only when status is "incomplete".
`data`	object	optional
`data.business_id`	integer	optional	Synup's internal numeric ID for the location.
`data.v4_business_id`	string	optional	Base64-encoded location identifier for the v4 API. Same value as data.location_id.
`data.location_id`	string	optional	Base64-encoded location identifier. Same value as data.v4_business_id.
`data.site`	object	optional	The directory the listing was synced to.
`data.site.id`	integer	optional	Synup's internal ID for the directory.
`data.site.name`	string	optional	Directory name (e.g. "Google", "Yelp", "Infobel").
`data.site.url`	string	optional	Root domain of the directory (e.g. "infobel.com").

Example delivery

{
  "event": "listing.submission",
  "status": "success",
  "live_link": "https://www.infobel.com/en/usa/example_business/portland/USOR000000-5550001000/businessdetails.aspx",
  "data": {
    "business_id": 1000001,
    "v4_business_id": "TG9jYXRpb246MTAwMDAwMQ==",
    "location_id": "TG9jYXRpb246MTAwMDAwMQ==",
    "site": {
      "id": 314,
      "name": "Infobel",
      "url": "infobel.com"
    }
  }
}