Create webhook endpoint
POST/api/webhooks
x-audience: "management"
x-required-scope: "webhooks:write"
name is trimmed (1–80 characters). Description is at most 300 characters. Destinations require public HTTPS on port 443 and pass DNS/address checks. Save signingSecret now: it is returned once. Optional payloadMapping shapes the complete body. Omit it or use null for the standard body.
Request
Responses
- 201
- 400
- 401
- 403
- 429
- 500
- 503
Success
Invalid fields or unsafe destination.
Missing, invalid or revoked credentials.
Required scope or account access missing.
Shared client-IP or account request allowance exhausted. Retry after the indicated number of seconds. Browser authentication errors can use a different response format.
Response Headers
no-store
Seconds to wait before retrying.
Creation failed.
Webhook secret encryption unavailable. Shared request limiting can also return 503 rate_limit_unavailable with Cache-Control: no-store.
Response Headers
Request limiter responses use no-store.