Create a webhook

POST

/auth/v1/seed/seed-webhooks

curl --request POST \
  --url /auth/v1/seed/seed-webhooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"name":"deploy-notifications","url":"https://hooks.example.com/outpost","secret":"whsec_a1b2c3d4e5f6","event_types":["deployment.succeeded","deployment.failed"],"namespaces":["acme"]}'

Body parameters

name

string

required

A descriptive name for the webhook.

url

string

required

The HTTPS endpoint URL that will receive event payloads.

secret

string

An optional HMAC signing secret. When provided, each delivery includes an `X-Outpost-Signature` header for payload verification.

event_types

string[]

required

Events to subscribe to. Available events: `service.created`, `service.deleted`, `service.scaled`, `job.completed`, `job.failed`, `deployment.succeeded`, `deployment.failed`, `dev.started`, `dev.stopped`.

namespaces

string[]

required

Namespaces to filter events for. Only events from these namespaces will be delivered.

Previous → Delete a token

Next List webhooks →