Submit campaign appeal for manual review

POST 
/campaign/:campaignId/appeal

Submits an appeal for rejected native campaigns in TELNYX_FAILED or MNO_REJECTED status. The appeal is recorded for manual compliance team review and the campaign status is reset to TCR_ACCEPTED. Note: Appeal forwarding is handled manually to allow proper review before incurring upstream charges.

Path Parameters

campaignId uuidrequired

The Telnyx campaign identifier

application/json

Body

required

Appeal request payload

appeal_reason stringrequired

Detailed explanation of why the campaign should be reconsidered and what changes have been made to address the rejection reason.

200: Appeal recorded successfully. Campaign status updated to TCR_ACCEPTED for manual compliance review.

application/json

• Schema
• Example (from schema)
• Example

Schema

appealed_at date-time

Timestamp when the appeal was submitted

previous_status stringnullable

Previous campaign status (currently always null)

{
  "appealed_at": "2024-07-29T15:51:28.071Z",
  "previous_status": "string"
}

{
  "appealed_at": "2025-08-06T15:30:45.123456",
  "previous_status": null
}

400: Campaign not in appealable status or invalid request

application/json

• Schema
• Example (from schema)

Schema

code stringrequired
title stringrequired
detail string

source

object

pointer string

JSON pointer (RFC6901) to the offending entity.

parameter string

Indicates which query parameter caused the error.

{
  "code": "string",
  "title": "string",
  "detail": "string",
  "source": {
    "pointer": "string",
    "parameter": "string"
  }
}

404: Campaign not found

application/json

• Schema
• Example (from schema)

Schema

code stringrequired
title stringrequired
detail string

source

object

pointer string

JSON pointer (RFC6901) to the offending entity.

parameter string

Indicates which query parameter caused the error.

{
  "code": "string",
  "title": "string",
  "detail": "string",
  "source": {
    "pointer": "string",
    "parameter": "string"
  }
}

422: Validation Error

application/json

• Schema
• Example (from schema)

Schema

detail

object[]

Array [

loc

object[]

required

Array [

anyOf

• MOD1
• MOD2

string

integer

]

msg Message (string)required

type Error Type (string)required

]

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Request samples

• cURL

---

curl -L 'https://api.telnyx.com/v2/10dlc/campaign/:campaignId/appeal' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "appeal_reason": "The website has been updated to include the required privacy policy and terms of service."
}'

Response samples

• 200
• 400
• 404
• 422

---

{
  "appealed_at": "2025-08-06T15:30:45.123456",
  "previous_status": null
}

{
  "code": "string",
  "title": "string",
  "detail": "string",
  "source": {
    "pointer": "string",
    "parameter": "string"
  }
}

{
  "code": "string",
  "title": "string",
  "detail": "string",
  "source": {
    "pointer": "string",
    "parameter": "string"
  }
}

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}