Skip to main content

Create New Phone Number Campaign

POST 
/phone_number_campaigns

Create New Phone Number Campaign

Request ​

Body

required

    phoneNumber Phonenumber (string)required

    The phone number you want to link to a specified campaign.

    campaignId Campaignid (string)required

    The ID of the campaign you want to link to the specified phone number.

Responses ​

200: Successful Response

Schema

    phoneNumber Phonenumber (string)required
    brandId BrandId (string)

    Brand ID. Empty if the number is associated to a shared campaign.

    tcrBrandId TcrBrandId (string)

    TCR's alphanumeric ID for the brand.

    campaignId Campaignid (string)required

    For shared campaigns, this is the TCR campaign ID, otherwise it is the campaign ID

    tcrCampaignId TcrCampaignid (string)

    TCR's alphanumeric ID for the campaign.

    telnyxCampaignId Telnyxcampaignid (string)

    Campaign ID. Empty if the number is associated to a shared campaign.

    assignmentStatus AssignmentStatus

    Possible values: [FAILED_ASSIGNMENT, PENDING_ASSIGNMENT, ASSIGNED, PENDING_UNASSIGNMENT, FAILED_UNASSIGNMENT]

    The assignment status of the number.

    failureReasons

    Extra info about a failure to assign/unassign a number. Relevant only if the assignmentStatus is either FAILED_ASSIGNMENT or FAILED_UNASSIGNMENT

    createdAt date-timerequired
    updatedAt date-timerequired

default: Unexpected error

Schema

    errors

    object[]

  • Array [

    • code integerrequired
    title stringrequired
    detail string

    source

    object

    pointer json-pointer

    JSON pointer (RFC6901) to the offending entity.

    parameter string

    Indicates which query parameter caused the error.

  • ]

Request samples

curl -L 'https://api.telnyx.com/10dlc/phone_number_campaigns' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "phoneNumber": "+18005550199",
  "campaignId": "4b300178-131c-d902-d54e-72d90ba1620j"
}'

Response samples

{
  "phoneNumber": "+18005550199",
  "brandId": "7ba705b7-22af-493f-addc-ac04b7ca071c",
  "tcrBrandId": "BBRAND1",
  "campaignId": "string",
  "tcrCampaignId": "CCAMPA1",
  "telnyxCampaignId": "3008dd9f-66d7-40e0-bf23-bf2d8d1a96ba",
  "assignmentStatus": "ASSIGNED",
  "createdAt": "2024-07-29T15:51:28.071Z",
  "updatedAt": "2024-07-29T15:51:28.071Z"
}