Reputation

Set the number-ownership webhook URL

Changed on

Set the HTTPS URL that receives number-ownership events for this enterprise: number_reputation.number.flagged, number_reputation.number.removed and number_reputation.external_verification.status_changed. Send webhook_url: null to stop receiving them.

patch/enterprises/{enterprise_id}/reputation/webhook

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/enterprises/{enterprise_id}/reputation/webhook
  • Auth: HTTP bearer

Path parameters

enterprise_idstring uuid required
Example:4a6192a4-573d-446d-b3ce-aff9117272a6

The enterprise id. Lowercase UUID.

Request body

webhook_urlstring uri nullable required

HTTPS URL on a publicly routable host. Send null to stop receiving number-ownership events.

Example request

{
  "webhook_url": "https://example.com/webhooks/telnyx"
}

Response

Updated reputation settings.

Example response

{
  "data": {
    "enterprise_id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
    "loa_document_id": "2a7e8337-e803-4057-a4ae-26c40eb0bc6c",
    "loa_status": "pending",
    "external_verification_status": "pending",
    "webhook_url": "https://example.com/webhooks/telnyx",
    "created_at": "2026-04-26T18:06:51.940749Z",
    "updated_at": "2026-04-26T18:09:24.785211Z"
  }
}

Changes