Webhooks

Create Webhook

Register a receiver. Deliveries are POSTs signed with the returned HMAC secret; secret documents the verification scheme. Business plan.

post/v1/webhooks

Request

  • Base URL: https://api.ensemble.markets (the document declares no server; this is the origin it was published from)
  • URL: https://api.ensemble.markets/v1/webhooks
  • Auth: HTTP bearer

Request body

urlstring uri required

HTTPS URL that receives signed POST deliveries

descriptionstring nullable

A label

Response

Successful Response

idstring required

Webhook ID (webhook_... or legacy UUID). Use the returned ID verbatim.

urlstring required

Receiver URL

secretstring required

HMAC signing secret. Verify a delivery by computing HMAC-SHA256(secret, '{t}.{raw_body}') and comparing it to the v1 value in the X-Ensemble-Signature header ('t=<ts>,v1=<hex>').

descriptionstring nullable
enabledboolean required

Whether deliveries are active

last_delivery_atstring date-time nullable

Most recent delivery attempt

last_delivery_statusstring nullable

HTTP status or error label of the most recent delivery

created_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.