> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracklysms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Number Draft

> Save partial number-request details and resume on the same request id.

Creates an account-owned number request with `status: "draft"`. A live API key with an associated user is required. This operation does not start business verification, submit to a carrier, send a pending-review notification, or publish a website.

The body must be a JSON object. Send any subset of the request-owned fields documented on [Create Number Request](/api-reference/v2/number-requests/create-request), except `businessVerification`; use the [dedicated binding operation](/api-reference/v2/number-requests/confirm-business) for explicit business confirmation. An empty object is accepted. Fields are type-checked and bounded when saved; full required-field and carrier validation runs at submission.

The public API supports customer-hosted opt-in URLs. Complete hosted-site previews and agent-prepared requests through owner review in Trackly.

Recognized US state and Canadian province names are saved as their two-letter codes. Incomplete state input remains editable until submission validation.

Use [PATCH Number Request](/api-reference/v2/number-requests/update-request) to save partial progress, [GET](/api-reference/v2/number-requests/get-request) to resume, and [Submit Draft](/api-reference/v2/number-requests/submit-draft) when complete.

## Request

```json theme={null}
{
  "brandName": "Acme Co",
  "listName": "Acme Alerts",
  "targetCountries": ["US"],
  "phoneNumberType": "toll_free"
}
```

## Response and retry

Returns `201` with `{"request": {...}}`. Store `request.id` and retain it throughout verification and corrections. Send an `Idempotency-Key` for safe create retries; reuse with a different body returns `409 idempotency_conflict`.

Invalid or unknown fields return a `400` error. Sandbox keys and keys without a user return `403`. See [the unified flow](/api-reference/v2/business-profiles/lifecycle) for verification and submission.