Skip to main content

Delete Phone Number Campaign

DELETE 
/phone_number_campaigns/:phoneNumber

This endpoint allows you to remove a campaign assignment from the supplied phoneNumber.

Request ​

Path Parameters

    phoneNumber Phonenumberrequired

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 -X DELETE 'https://api.telnyx.com/10dlc/phone_number_campaigns/:phoneNumber' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

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"
}