---
title: "Add entries in bulk"
method: POST
path: "/v1/draws/{id}/entries"
tags: ["Draws"]
---

# Add entries in bulk

`POST /v1/draws/{id}/entries`

Up to 5,000 entries per request. `ticket_id` is optional — omit it and
the server generates a Crockford-Base32 ticket. Supplied tickets must
match `[A-Za-z0-9_\-\.]+` and be unique within the draw.

## Request body

- object
  - `entries` EntryInput[], required
    - `ticket_id` string — Optional — omit to auto-generate. Your own customer ids, order numbers, or email hashes all work.
    - `metadata` object, nullable — Opaque to ProofDraw; stored as-is.

## Response `201`

Entries added.

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `added` integer
    - `entry_count` integer
    - `tickets` string[]

## Other responses

- `401` — Missing or invalid API key (`unauthenticated`).
- `404` — Draw not found or not yours (`not_found`).
- `409` — Operation not valid in the draw's current state (`state_conflict`).
- `422` — Invalid payload (`validation_failed` / `entry_limit_exceeded`).

---

[API](https://skmtc.net/proofdraw/apis/proofdraw-api.md) · [All operations](https://skmtc.net/proofdraw/apis/proofdraw-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/proofdraw/proofdraw-api/revisions/5d4ce7cb355d/schema)