---
title: "Agree to the Phone Number Reputation Terms of Service"
method: POST
path: "/terms_of_service/number_reputation/agree"
tags: ["Terms of Service"]
---

# Agree to the Phone Number Reputation Terms of Service

`POST /terms_of_service/number_reputation/agree`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/terms_of_service/number_reputation/agree`
- Auth: HTTP bearer

Records the authenticated user's agreement to the current Phone Number Reputation ToS. No body required. Idempotent.

Prerequisite for using any of the `/v2/.../reputation/*` endpoints.

## Response `201`

Agreement recorded.

- TosAgreementWrapped
  - `data` TosAgreement, required: A recorded user agreement to a product's Terms of Service. The `user_id` is intentionally NOT echoed back on this public surface - the caller already knows their own identity.
    - `id` string, uuid: The unique identifier of this recorded agreement.
    - `terms_version` string: The version of the terms you accepted.
    - `version` string: Convenience alias of `terms_version`. Both keys are present on every response.
    - `product_type` 'branded_calling' | 'number_reputation': Telnyx product the Terms of Service apply to.
    - `agreed_at` string, date-time: When you accepted this version of the terms.
    - `created_at` string, date-time: When this agreement record was created.

## Other responses

- `default`: An error occurred. The response carries the standard Telnyx error envelope.
- `4XX`: An error occurred. The response carries the standard Telnyx error envelope.

## Changes

- **2026-06-05** `8a8c40f458c5`: 1 breaking, 5 info
  - removed the success response with the status `200`
  - api operation id `AgreeNumberReputationTermsOfService` removed and replaced with `agreeNumberReputationTermsOfService`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - …2 more

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/terms_of_service/number_reputation/agree/post.md)

---

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