SYsynup
Webhooks/Webhooks
Webhooks

New review received for a location

Event name: interaction.review

Sent when Synup detects a new review for one of your locations on any monitored platform (Google, Yelp, TripAdvisor, etc.). Delivered to your Webhooks URL (Reviews webhook — requires the reviews webhook permission). Location-scoped. Social-category interactions are not delivered.

postWebhookinteraction.review

Headers

X-Synup-Signaturestring required

sha256=base64(HMAC-SHA256(signing_secret, raw_request_body)). Present when the account has generated a signing secret; verify before processing.

Payload

eventstring

Dotted event name.

timestampstring

ISO-8601 datetime Synup detected and processed this interaction (UTC).

account_idinteger

The Synup account that owns this location.

location_idstring

Synup's numeric location ID, as a string.

agency_account_idinteger

Present only when the account is managed by a parent agency account.

Response

Acknowledge with any 2xx. A non-2xx (or timeout) is recorded as a failed delivery; failures are logged but not automatically retried at this time.

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.