---
title: "Enable phone-number reputation for an enterprise"
method: POST
path: "/enterprises/{enterprise_id}/reputation"
tags: ["Reputation"]
---

# Enable phone-number reputation for an enterprise

`POST /enterprises/{enterprise_id}/reputation`

Activate Phone Number Reputation for the given enterprise. Requires an uploaded Letter of Authorization document (the `loa_document_id` references the Telnyx Documents API) and a refresh-frequency selection. After activation, individual phone numbers can be registered via `POST .../reputation/numbers`.

**Prerequisite**: the calling user must have agreed to the Phone Number Reputation Terms of Service (`POST /terms_of_service/number_reputation/agree`).

Failure modes:
- `403` - Phone Number Reputation Terms of Service not accepted.
- `404` - enterprise does not exist or does not belong to your account.
- `400` - reputation already enabled for this enterprise.
- `422` - `loa_document_id` missing or `check_frequency` invalid.

**Pricing:** This is a billable action. See https://telnyx.com/pricing/numbers for current pricing.

## Path parameters

- `enterprise_id` string, uuid, required

## Request body

- EnterpriseReputationCreate
  - `loa_document_id` string, required — Id of the signed Letter of Authorization document, returned by the Telnyx Documents API after upload (upload via `POST /v2/documents`; see https://developers.telnyx.com/api/documents).
  - `check_frequency` 'business_daily' | 'daily' | 'weekly' | 'biweekly' | 'monthly' | 'never' — How often Telnyx refreshes the stored reputation data for this enterprise's registered numbers.

## Response `201`

Reputation enabled.

- 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`.
    - `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.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/versions/e32d46c5945b/schema)