Skip to main content
POST
Create a webhook source

Authorizations

x-api-key
string
header
required

Workspace API key. Current accepted keys use the ando_sk_ prefix.

Headers

Idempotency-Key
string
required

Required key for safe retries. Reusing it with different parameters returns 409 idempotency_conflict. The original result can be replayed for 24 hours while the created source or route remains unchanged. Idempotency key.

Maximum string length: 255

Body

application/json

Inbound webhook source creation request. provider names a supported preset (sentry, linear, github, forgejo, gitlab, granola, notion, clickup, stripe, calendly, eas, app_store_connect, convex, posthog, pagerduty, grafana, attio); the preset supplies signature verification and event normalization.

provider
string
required

Inbound provider preset key.

display_name
string | null

Optional label for the author identity events post as. The source itself keeps the provider's canonical name.

signing_secret
string | null

Signing secret the provider will use. Generated when omitted.

Response

Created inbound webhook source.

Created inbound webhook source. The signing secret is returned exactly once.

data
object
required

Created source with its signing secret.