SYsynup
Webhooks/Webhooks
Webhooks

New response to a review received

Event name: interaction.response

Sent when Synup detects a new response to an existing review — including responses posted through Synup and responses detected directly on the platform. Responses arrive asynchronously, often well after the original review. Delivered to your Webhooks URL (Reviews webhook). Location-scoped. Use data.interaction.parent_id to link the response to the review it answers.

postWebhookinteraction.response

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.