---
title: "Activate Branded Calling on an enterprise"
method: POST
path: "/enterprises/{enterprise_id}/branded_calling"
tags: ["Enterprises"]
---

# Activate Branded Calling on an enterprise

`POST /enterprises/{enterprise_id}/branded_calling`

Branded Calling is a paid product that must be activated on each enterprise. Activation is idempotent:
- First call: marks the enterprise as activated and begins onboarding it with the Branded Calling platform asynchronously. Returns `200` with `branded_calling_enabled: true`.
- Re-call after success: no-op, returns the same enterprise body.
- Re-call after a prior failure: re-queues onboarding, returns `200`.

Prerequisite: the calling user must have agreed to the Branded Calling Terms of Service (`POST /terms_of_service/branded_calling/agree`). Without that, this endpoint returns `403 terms_of_service_not_accepted`.

Failure modes:
- `403` - Branded Calling Terms of Service not accepted.
- `404` - enterprise does not exist or does not belong to your account.

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

## Path parameters

- `enterprise_id` string, uuid, required

## Response `200`

Branded Calling activated.

- EnterprisePublicWrapped
  - `data` EnterprisePublic, required
    - `id` string, uuid
    - `legal_name` string
    - `organization_type` string
    - `country_code` string
    - `role_type` string
    - `website` string
    - `fein` string
    - `industry` string
    - `number_of_employees` string
    - `organization_legal_type` string
    - `doing_business_as` string
    - `jurisdiction_of_incorporation` string
    - `customer_reference` string
    - `primary_business_domain_sic_code` string, nullable — Optional SIC code for the primary line of business.
    - `corporate_registration_number` string, nullable — Optional corporate-registration / company-number identifier.
    - `professional_license_number` string, nullable — Optional professional-license number for regulated industries.
    - `dun_bradstreet_number` string, nullable — Optional D-U-N-S Number issued by Dun & Bradstreet.
    - `organization_contact` OrganizationContact
      - `first_name` string, required
      - `last_name` string, required
      - `email` string, email, required
      - `job_title` string, required
      - `phone_number` string, required — E.164 format with leading `+`.
    - `billing_contact` BillingContact
      - `first_name` string, required
      - `last_name` string, required
      - `email` string, email, required
      - `phone_number` string, required — E.164 format with leading `+`.
    - `organization_physical_address` PhysicalAddress
      - `country` string, required — ISO 3166-1 alpha-2 code (currently `US` or `CA`).
      - `administrative_area` string, required — State or province code (e.g. `IL`, `ON`).
      - `city` string, required
      - `postal_code` string, required
      - `street_address` string, required
      - `extended_address` string, nullable
    - `billing_address` BillingAddress
      - `country` string, required — ISO 3166-1 alpha-2 code (currently `US` or `CA`).
      - `administrative_area` string, required — State or province code (e.g. `IL`, `ON`).
      - `city` string, required
      - `postal_code` string, required
      - `street_address` string, required
      - `extended_address` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `branded_calling_enabled` boolean — True once Branded Calling has been activated on this enterprise (see `POST /enterprises/{id}/branded_calling`).
    - `number_reputation_enabled` boolean — True once Phone Number Reputation has been enabled on this enterprise (see `POST /enterprises/{id}/reputation`).

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

---

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