---
title: "Create New Phone Number Campaign"
method: POST
path: "/10dlc/phone_number_campaigns"
tags: ["Phone Number Campaigns"]
---

# Create New Phone Number Campaign

`POST /10dlc/phone_number_campaigns`

Assigns a phone number to a 10DLC campaign. The assignment controls which registered campaign is used for traffic from that number.

## Request body

- PhoneNumberCampaignCreate
  - `campaignId` string, required — The ID of the campaign you want to link to the specified phone number.
  - `phoneNumber` string, required — The phone number you want to link to a specified campaign.

## Response `200`

Successful Response

- PhoneNumberCampaign
  - `assignmentStatus` 'FAILED_ASSIGNMENT' | 'PENDING_ASSIGNMENT' | 'ASSIGNED' | 'PENDING_UNASSIGNMENT' | 'FAILED_UNASSIGNMENT' — The assignment status of the number.
  - `brandId` string — Brand ID. Empty if the number is associated to a shared campaign.
  - `campaignId` string, required — For shared campaigns, this is the TCR campaign ID, otherwise it is the campaign ID
  - `createdAt` string, required
  - `failureReasons` string — Extra info about a failure to assign/unassign a number. Relevant only if the assignmentStatus is either FAILED_ASSIGNMENT or FAILED_UNASSIGNMENT
  - `nonTmobileNumberMappingStatus` string — The assignment status of the number towards other carriers.
  - `phoneNumber` string, required
  - `tcrBrandId` string — TCR's alphanumeric ID for the brand.
  - `tcrCampaignId` string — TCR's alphanumeric ID for the campaign.
  - `telnyxCampaignId` string — Campaign ID. Empty if the number is associated to a shared campaign.
  - `tmobileNumberMappingStatus` string — The T-Mobile assignment status of the number.
  - `updatedAt` string, required

## Other responses

- `4XX` — Generic response error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)