Webhooks/Webhooks
Webhooks

AI post idea generated

Event name: idea.generated

A new AI post idea was generated. Scope: local or social (see the top-level scope field). Delivered as a signed HTTP POST to your Webhooks URL.

postWebhookidea.generated

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.

scopestring

AI post-idea events only: "local" or "social".

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.