secret used to verify the HMAC-SHA256 signature on every delivery — save it immediately, as it cannot be retrieved again. This endpoint requires the webhooks:write permission.
Request
Headers
Request body
The HTTPS URL that will receive webhook event payloads. HTTP is accepted in development environments only.
One or more event types to subscribe to. The array must not be empty. Available values:
Optional human-readable label to help identify this webhook. Useful when you manage multiple endpoints.
For donors who give in a display currency, the
donation.* payloads and the subscription.created, subscription.updated and subscription.cancelled payloads may carry display-only currency fields (displayCurrency, displayAmount, fxRate, fxRateTableId, fxRateAsOf, and on subscriptions lastChargeFx). subscription.payment_method_updated never does. See Event payloads.Response
201 — created
HMAC-SHA256 signing secret for verifying webhook payloads. Shown only once. Use this value to validate the
X-Webhook-Signature header on incoming deliveries.400 — bad request
Returned when required fields are missing, theurl is not a valid HTTPS URL, or events is empty.
401 — unauthorized
Returned when your API key is missing, invalid, or lacks thewebhooks:write permission.
Example
Sample response (201)