Sign in
latestOpenAPI 3.0.32026-08-10161240.1 KB

5d4ce7cb355d

Draws

Create a draw

Creates a draw in state open. If callback_url is set, the response includes callback_secret (HMAC key for webhook signatures) — this is the only time it is returned.

post/v1/draws

Request body

namestring required
descriptionstring nullable
direction'winner' | 'loser'
winner_countinteger

Multi-winner draws are enterprise-only in v1.

drand_chain'quicknet' | 'classic'
callback_urlstring nullable

Webhook target for draw.sealed / draw.resolved / draw.cancelled events.

metadataobject nullable

Opaque

Response

Draw created.

successboolean
messagestring

Example response

{
  "success": true,
  "data": {
    "draw": {
      "id": "K7M2"
    }
  }
}