Number removed for an ownership reason
A monitored number was removed from reputation monitoring because its ownership could not be kept verified. Removing a number yourself with DELETE does not send this event.
Sent to the enterprise’s ownership webhook URL (PATCH /enterprises/{enterprise_id}/reputation/webhook). This webhook uses Telnyx headers (telnyx-timestamp, telnyx-signature-ed25519) that are compatible with Standard Webhooks specification for SDK generation. Custom validation logic can map these to standard webhook-timestamp and webhook-signature equivalents. See https://github.com/standard-webhooks/standard-webhooks for details.
{
"data": {
"record_type": "event",
"id": "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
"occurred_at": "2026-10-05T07:00:12.521992Z",
"event_type": "number_reputation.number.removed",
"payload": {
"record_type": "reputation_phone_number",
"phone_number": "+13125550142",
"enterprise_id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
"source": "external",
"ownership_status": "removed",
"removal_reason": "unconfirmed_ownership",
"removed_at": "2026-10-09T07:00:03+00:00"
}
},
"meta": {
"attempt": 1,
"delivered_to": "https://example.com/webhooks/telnyx"
}
}Authorizations
Telnyx API key. Generate one at https://portal.telnyx.com/#/app/api-keys.
Headers
Unix timestamp (seconds since epoch) of when the webhook was sent - compatible with webhook-timestamp
Ed25519 signature of the payload - compatible with webhook-signature
Body
Response
Return an HTTP 200 to acknowledge receipt; otherwise delivery is retried.
Was this page helpful?
{
"data": {
"record_type": "event",
"id": "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
"occurred_at": "2026-10-05T07:00:12.521992Z",
"event_type": "number_reputation.number.removed",
"payload": {
"record_type": "reputation_phone_number",
"phone_number": "+13125550142",
"enterprise_id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
"source": "external",
"ownership_status": "removed",
"removal_reason": "unconfirmed_ownership",
"removed_at": "2026-10-09T07:00:03+00:00"
}
},
"meta": {
"attempt": 1,
"delivered_to": "https://example.com/webhooks/telnyx"
}
}