Skip to main content
POST
Register a webhook

Authorizations

Authorization
string
header
required

Your API key (cb_live_…), sent as a bearer token, with the scope nft:orders. Keep it on your servers: never in a browser, app or wallet. Use a separate key per environment. A request from a country on our sanctions list gets a 403 with Access denied, whether or not it has a valid key. See Authentication and keys.

Scopes

nft:orders

Body

application/json
url
string<uri>
required

A public https:// URL.

Maximum string length: 2048

Response

The URL changed. secret is null; the secret is unchanged.

webhook
object
required
secret
string | null
required

The signing secret (whsec_…), only on the first registration. Used whole as the HMAC key.