Skip to main content
WEBHOOK

Headers

X-CatchBack-Signature
string
required

t=<unix seconds>,v1=<hex>. v1 is the HMAC-SHA256 of <t>.<raw request body>, keyed with your whole secret, whsec_ included. Compute it over the raw bytes before any JSON parsing, compare in constant time, and refuse a t more than 300 seconds from your clock. Each retry is signed afresh.

X-CatchBack-Event
string
required

The event's type.

X-CatchBack-Event-Id
string
required

The event's id, which stays the same on every retry. Dedupe on it.

X-CatchBack-Attempt
integer
required

Which try this is, from 1 to 8.

Required range: 1 <= x <= 8

Body

application/json
id
string
required

Dedupe on it: a retry carries the same id and the same body.

type
enum<string>
required
Available options:
nft_order.updated,
sellback.updated,
nft_shipment.updated,
ping
Allowed value: "sellback.updated"
created_at
string<date-time>
required

When the change happened.

data
object
required

The current state, not a diff.

Response

200

Answer any 2xx within 5 seconds, and do slow work after you've answered. Anything else counts as a failure, including a redirect (we never follow one). We retry after 1 minute, 5 minutes, 30 minutes, 2, 6, 12 and 24 hours, then drop the event after 8 attempts; poll to catch up. Delivery is at-least-once and unordered, so dedupe on id.