Skip to main content
POST
/
enterprises
/
{enterprise_id}
/
reputation
/
remediation
JavaScript
import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const response = await client.enterprises.reputation.remediation.submit(
  '4a6192a4-573d-446d-b3ce-aff9117272a6',
  {
    call_purpose: 'Appointment reminders for our dental clinic.',
    phone_numbers: ['+19493253498', '+12134445566'],
    contact_email: 'ops@example.com',
    webhook_url: 'https://example.com/webhooks/remediation',
  },
);

console.log(response.data);
{
  "data": {
    "id": "b7c1f1c0-7a9d-4f0a-9d3e-2f6a1c4b8e21",
    "status": "in_progress",
    "phone_numbers_count": 2,
    "phone_numbers_submitted": 2,
    "phone_numbers_ineligible": 0,
    "call_purpose": "Appointment reminders for our dental clinic.",
    "created_at": "2026-06-01T12:00:00Z",
    "updated_at": "2026-06-01T12:05:00Z",
    "contact_email": "ops@example.com",
    "webhook_url": "https://example.com/webhooks/remediation",
    "tier1_completed_at": "2023-11-07T05:31:56Z",
    "tier2_completed_at": "2023-11-07T05:31:56Z",
    "results": {
      "remediated": [
        "+19493253498"
      ],
      "not_flagged": [
        "<string>"
      ],
      "requires_review": [
        "<string>"
      ],
      "ineligible": [
        "<string>"
      ],
      "refused": [
        "<string>"
      ]
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
enterprise_id
string<uuid>
required

The enterprise id. Lowercase UUID.

Example:

"4a6192a4-573d-446d-b3ce-aff9117272a6"

Body

application/json
​
phone_numbers
string[]
required

Phone numbers in E.164 format. Each must belong to this enterprise. Maximum 2,000 per request.

Required array length: 1 - 2000 elements
Pattern: ^\+[1-9][0-9]{9,14}$
​
call_purpose
string
required

How the numbers are used (free text).

Required string length: 1 - 2000
Example:

"Appointment reminders for our dental clinic."

​
contact_email
string<email>

Optional contact email for this remediation request.

Maximum string length: 255
Example:

"ops@example.com"

​
webhook_url
string<uri>

Optional https:// URL for status notifications.

Maximum string length: 2048
Example:

"https://example.com/webhooks/remediation"

Response

Remediation request accepted and persisted.

​
data
object
required

Full detail of a remediation request, returned on submit and GET by id.