---
title: "Set the number-ownership webhook URL"
method: PATCH
path: "/enterprises/{enterprise_id}/reputation/webhook"
tags: ["Reputation"]
---

# Set the number-ownership webhook URL

`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

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.

## Path parameters

- `enterprise_id` string, uuid, required

## Request body

- EnterpriseReputationWebhookUpdate
  - `webhook_url` string, uri, nullable, required: HTTPS URL on a publicly routable host. Send `null` to stop receiving number-ownership events.

## Response `200`

Updated reputation settings.

- EnterpriseReputationPublicWrapped
  - `data` EnterpriseReputationPublic, required
    - `enterprise_id` string, uuid
    - `status` 'pending' | 'approved' | 'deleted' | 'rejected': Lifecycle status of the enterprise's Phone Number Reputation activation.
    - `check_frequency` 'business_daily' | 'daily' | 'weekly' | 'biweekly' | 'monthly' | 'never': How often Telnyx refreshes the stored reputation data for this enterprise's registered numbers.
    - `loa_document_id` string, nullable: Id of the signed LOA document.
    - `loa_status` 'pending' | 'approved' | 'rejected': Customer-facing Letter-of-Authorization verification state. `approved` is required (alongside reputation status) before phone numbers can be added.
    - `rejection_reasons` string[], nullable: Populated when `status` is `rejected`.
    - `external_verification_status` 'pending' | 'approved' | 'rejected': Review state of the ownership proof that allows adding phone numbers hosted with another provider.
    - `webhook_url` string, uri, nullable: HTTPS URL that receives number-ownership webhook events for this enterprise.
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `400`: An error occurred. The response carries the standard Telnyx error envelope.
- `401`: An error occurred. The response carries the standard Telnyx error envelope.
- `404`: An error occurred. The response carries the standard Telnyx error envelope.

## Changes

> 152 revisions in range; 1 not diffed.

- **2026-10-15** `da303e40b51e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/enterprises/:enterprise_id/reputation/webhook/patch.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)