SYsynup
Webhooks/Webhooks
Webhooks

Share-of-Voice snapshot completed

Event name: rankings.sov_snapshot_completed

A Share-of-Voice snapshot was stored for a keyword (one event per keyword). Scope: location-scoped. Delivered as a signed HTTP POST to your Webhooks URL.

postWebhookrankings.sov_snapshot_completed

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.