Skip to content
API referenceAPI v1admin-sdk 1.1.52Search docs⌘K
Webhook endpoints · Add an endpoint
API reference / Webhook endpoints

Add an endpoint

POST/api/v1/webhook_urlswebhooks:manage

Adds a URL that gets one event, or a group: orders, subscriptions or all. Webhooks.

Body

urlstringrequired

Your endpoint, up to 512 characters. Use HTTPS.

eventstringrequired

One event like orders.paid, or a group: orders, subscriptions, all, or the families subscription, card_charge, refund. Event types.

merchant_idinteger

For an organisation key: the merchant it's for.

Headers

Authorizationheaderrequired

Bearer with your secret key, or the merchant's OAuth token.

Returns

The endpoint.

Errors

401The key or token is missing, wrong or revoked, is for the other environment, or doesn't have the scope this endpoint needs.
422The URL or event is missing, or the URL isn't a web address.