---
title: "POST /v2/agent/number-requests"
method: POST
path: "/v2/agent/number-requests"
tags: ["agent-number-requests-v2"]
---

# POST /v2/agent/number-requests

`POST /v2/agent/number-requests`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/agent/number-requests`
- Auth: API key in header `Authorization`

## Headers

- `Idempotency-Key` string, required

## Request body

- AgentNumberRequestCreate
  - `addressCity` string: Request-owned registration field; optional fields may be cleared
  - `addressCountry` string: Request-owned registration field; optional fields may be cleared
  - `addressPostalCode` string: Request-owned registration field; optional fields may be cleared
  - `addressState` string: Request-owned registration field; optional fields may be cleared
  - `addressStreet` string: Request-owned registration field; optional fields may be cleared
  - `brandName` string, required
  - `businessContactEmail` string: Request-owned registration field; optional fields may be cleared
  - `businessContactFirstName` string: Request-owned registration field; optional fields may be cleared
  - `businessContactLastName` string: Request-owned registration field; optional fields may be cleared
  - `businessDescription` string: Request-owned registration field; optional fields may be cleared
  - `companyLegalName` string: Request-owned registration field; optional fields may be cleared
  - `contactEmail` string: Request-owned registration field; optional fields may be cleared
  - `contactPhone` string: Request-owned registration field; optional fields may be cleared
  - `customDomain` string: Request-owned registration field; optional fields may be cleared
  - `estimatedMonthlyVolume` string: Request-owned registration field; optional fields may be cleared
  - `exampleSmsMessage` string: Request-owned registration field; optional fields may be cleared
  - `identifierType` string: Request-owned registration field; optional fields may be cleared
  - `industry` string: Request-owned registration field; optional fields may be cleared
  - `listName` string: Request-owned registration field; optional fields may be cleared
  - `messagingType` string: Request-owned registration field; optional fields may be cleared
  - `optInFormUrl` string: Request-owned registration field; optional fields may be cleared
  - `phoneNumberType` 'toll_free' | '10dlc'
  - `privacyPolicyUrl` string: Request-owned registration field; optional fields may be cleared
  - `promotionSummary` string: Request-owned registration field; optional fields may be cleared
  - `targetCountries` string[]
  - `taxId` string: Request-owned registration field; optional fields may be cleared
  - `termsConditionsUrl` string: Request-owned registration field; optional fields may be cleared
  - `useOwnOptInUrl` boolean
  - `vertical` string: Request-owned registration field; optional fields may be cleared
  - `websiteUrl` string: Request-owned registration field; optional fields may be cleared

## Response `201`

Inert draft created or replayed

- AgentNumberRequestResponse
  - `request` object: Bound request id/accountId/revision/status, fields, preview, domain, registration and nextActions

## Other responses

- `400`: Invalid request
- `401`: Invalid credentials
- `403`: Registration scope required
- `404`: Bound request not found
- `409`: State changed or operation outcome unknown
- `413`: Request too large
- `422`: Incomplete or unsupported registration
- `429`: Preview budget exhausted
- `503`: Dependency unavailable

---

[API](https://skmtc.dev/tracklysms/apis/trackly-sms-api.md) · [All operations](https://skmtc.dev/tracklysms/apis/trackly-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracklysms/apis/trackly-sms-api/revisions/ac1ad22cb2a9?raw)