---
title: "Create phone number assignment order"
method: POST
path: "/api/relay/rest/registry/beta/campaigns/{id}/orders"
tags: ["Campaign Registry: Phone Number Assignments"]
---

# Create phone number assignment order

`POST /api/relay/rest/registry/beta/campaigns/{id}/orders`

## Request

- Base URL: `https://{Your_Space_Name}.signalwire.com`
- URL: `https://{Your_Space_Name}.signalwire.com/api/relay/rest/registry/beta/campaigns/{id}/orders`
- Auth: HTTP basic

Submits a batch request to assign project phone numbers to one US 10-digit long code (10DLC) campaign. Use it after the brand and campaign are registered and the numbers are owned by the project. Monitor processing with [Get phone number assignment order](/docs/apis/rest/campaign-registry/phone-number-assignments/retrieve-order).

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Messaging_ and _Numbers_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Path parameters

- `id` string, uuid, required: Universal Unique Identifier.

## Request body

- CreateOrderRequest: Request body for creating an order.
  - `phone_numbers` string[]: A list of phone numbers in E164 format.
  - `status_callback_url` string: Optional: Specify a URL to receive webhook notifications when your number assignment order and the number assignments that belong to it change state. See the [10DLC status callback](/docs/apis/rest/webhooks/ten-dlc-status-callback) docs for the webhook payload.

## Response `200`

The request has succeeded.

- OrderResponse: Response containing a single order.
  - `id` string, uuid, required: Universal Unique Identifier.
  - `state` string: The current state of the order.
  - `processed_at` string, date-time: Timestamp when the order was processed.
  - `created_at` string, date-time: Timestamp when the order was created.
  - `updated_at` string, date-time: Timestamp when the order was last updated.
  - `status_callback_url` string: Optional: Specify a URL to receive webhook notifications when your number assignment order and the number assignments that belong to it change state. See the [10DLC status callback](/docs/apis/rest/webhooks/ten-dlc-status-callback) docs for the webhook payload.

## Other responses

- `401`: Access is unauthorized.
- `404`: The server cannot find the requested resource.
- `422`: The request failed validation. See errors for details.
- `500`: An internal server error occurred.

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) - [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signalwire/apis/signalwire-rest-api/revisions/7307749294e0?raw)