---
title: "Create Number"
method: POST
path: "/v1/numbers"
tags: ["numbers"]
---

# Create Number

`POST /v1/numbers`

Provision a new SMS-enabled phone number.

1. Check number limit (lifetime limit)
2. Search the account's configured SMS provider for available numbers
3. Purchase the first available one
4. Configure messaging and voice routing
5. Store the number in our database

## Request body

- CreateNumberRequest
  - `country` string
  - `areaCode` string, nullable
  - `agentId` string, nullable

## Response `200`

Successful Response

- PhoneNumberResponse
  - `id` string, required
  - `phoneNumber` string, required
  - `country` string, required
  - `status` string, required
  - `type` string
  - `agentId` string, nullable
  - `outboundSms` 'enabled' | 'activating' | 'registration_required'
  - `createdAt` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/agentphone/apis/agentphone-api.md) · [All operations](https://skmtc.net/agentphone/apis/agentphone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agentphone/agentphone-api/versions/5724ccaa33d8/schema)