# Create private draft

> Create a private owner-bound product draft with a personal API key. Category can be omitted while drafting; choose one in the editor before selecting a plan or submitting.

Canonical: https://www.listbulb.com/docs/api/endpoints/create-draft
Last updated: 2026-11-22

`POST /api/v1/tools`

## Parameters

| Name | Location | Required | Detail |
| --- | --- | --- | --- |
| `Authorization` | Header | Required | Bearer lb_… personal API key. |
| `Idempotency-Key` | Header | Required | Unique key for this draft; 16–256 characters. |
| `Content-Type` | Header | Required | application/json. |
| `name` | Body | Required | Trimmed string; 1–160 characters. |
| `headline` | Body | Required | Trimmed string; 1–200 characters. |
| `description` | Body | Required | Trimmed string; 200–2,000 characters. |
| `websiteUrl` | Body | Required | Valid URL; up to 2,000 characters. |
| `screenshotUrls` | Body | Optional | Array of 1–4 publicly reachable screenshot URLs; otherwise the product Open Graph image is used. |
| `category` | Body | Optional | If supplied: an existing category slug, trimmed, 1–120 characters. Omit it when undecided; empty strings and unknown slugs are rejected. Required before selecting a plan or submitting. |
| `logoUrl` | Body | Optional | Valid URL; otherwise the product favicon is used. Returns 422 if both media items cannot be resolved. |
| `slug` | Body | Optional | Trimmed string; 1–120 characters. A slug is generated when omitted. |

## Example

```bash
curl -X POST https://www.listbulb.com/api/v1/tools \
  -H "Authorization: Bearer lb_your_secret" \
  -H "Idempotency-Key: a-unique-key-per-product" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme","headline":"A focused workspace","description":"Acme is a focused workspace that helps small teams organize their projects, capture useful notes, and collaborate on everyday work. This private draft is prepared for the founder to review, complete, and submit through the normal ListBulb workflow.","websiteUrl":"https://acme.example","screenshotUrls":["https://acme.example/screenshot.png"]}'
```

## Returns

`201 { data: { slug, status: "DRAFT", editorUrl }, meta }; the Location header repeats the private editor URL.`

## Errors

- `400 VALIDATION_ERROR or IDEMPOTENCY_KEY_REQUIRED`
- `401 API_KEY_REQUIRED`
- `403 OWNER_UNAVAILABLE`
- `409 IDEMPOTENCY_CONFLICT`
- `422 MEDIA_REQUIRED`
- `429 RATE_LIMITED`
- `503 RATE_LIMIT_UNAVAILABLE`

## Related
- [All REST API endpoints](https://www.listbulb.com/docs/api/endpoints)
