Skip to content

Delete a webhook owned by the authenticated brand.

DELETE
/brands/me/webhooks/{id}

Hard deletes the webhook and cascades to its delivery logs. Queued deliveries for this webhook silently drop on the next retry because the worker skips missing/disabled endpoints.

id
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/

Webhook UUID.

X-Polst-Idempotency-Key
required
string
>= 8 characters <= 255 characters

Idempotency key, 8–255 URL-safe chars.

Webhook deleted.

Missing idempotency key.

Missing or invalid bearer token.

Bearer token lacks manage scope or brand context.

Webhook not found or not owned by the caller.

WebhookId is not a UUID.