Webhooks/Webhooks
Webhooks

Review posted (campaign-attributed)

Event name: campaign.review_posted

A new review landed at a location with at least one active campaign within the 30-day attribution window. Attribution is location-level. Scope: location-scoped. Delivered as a signed HTTP POST to your Webhooks URL.

postWebhookcampaign.review_posted

Headers

X-Synup-Signaturestring required

sha256=base64(HMAC-SHA256(signing_secret, raw_request_body)). Verify with your signing secret before processing; reject on mismatch.

Payload

eventstring

Dotted event name.

timestampstring

ISO-8601 UTC time the event was emitted.

account_idinteger

Synup account the event belongs to.

location_idstring

Numeric string for location-scoped events; null for brand-scoped events.

Response

Your endpoint acknowledges receipt with any 2xx. A non-2xx response or a timeout (>10s) is treated as a failed delivery.

object required

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.