Skip to main content
POST
Create Number Draft
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, except businessVerification; use the dedicated binding operation 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 to save partial progress, GET to resume, and Submit Draft when complete.

Request

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 for verification and submission.