Activate Branded Calling on an enterprise

Branded Calling must be activated on each enterprise. Activation is idempotent:

First call: marks the enterprise as activated, effective immediately; you can create a DIR right away. The enterprise is registered with the Branded Calling platform later, after its first DIR is approved. Returns 200 with branded_calling_enabled: true.
Re-call after success: no-op, returns the same enterprise body.
Re-call after a failed registration: re-queues the registration, 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:

400 - the account has no available credit. Add funds and retry.
400 - the enterprise is not in the United States. Branded Calling is currently available only to US enterprises.
403 - Branded Calling Terms of Service not accepted.
404 - enterprise does not exist or does not belong to your account.

Pricing: Activation itself is free, but the account must have available credit. Branded Calling fees are charged per DIR and per branded call. See https://telnyx.com/pricing/branded-calling for current pricing.

POST

enterprises

{enterprise_id}

branded_calling

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const response = await client.enterprises.activateBrandedCalling(
  '4a6192a4-573d-446d-b3ce-aff9117272a6',
);

console.log(response.data);

import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
)
response = client.enterprises.activate_branded_calling(
    "4a6192a4-573d-446d-b3ce-aff9117272a6",
)
print(response.data)

package main

import (
	"context"
	"fmt"

	"github.com/team-telnyx/telnyx-go"
	"github.com/team-telnyx/telnyx-go/option"
)

func main() {
	client := telnyx.NewClient(
		option.WithAPIKey("My API Key"),
	)
	response, err := client.Enterprises.ActivateBrandedCalling(context.TODO(), "4a6192a4-573d-446d-b3ce-aff9117272a6")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.Data)
}

package com.telnyx.sdk.example;

import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.enterprises.EnterpriseActivateBrandedCallingParams;
import com.telnyx.sdk.models.enterprises.EnterpriseActivateBrandedCallingResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        TelnyxClient client = TelnyxOkHttpClient.fromEnv();

        EnterpriseActivateBrandedCallingResponse response = client.enterprises().activateBrandedCalling("4a6192a4-573d-446d-b3ce-aff9117272a6");
    }
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');

try {
  $response = $client->enterprises->activateBrandedCalling(
    '4a6192a4-573d-446d-b3ce-aff9117272a6'
  );

  var_dump($response);
} catch (APIException $e) {
  echo $e->getMessage();
}

{
  "data": {
    "id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
    "legal_name": "Acme Plumbing LLC",
    "organization_type": "commercial",
    "country_code": "US",
    "role_type": "enterprise",
    "website": "https://acmeplumbing.example.com",
    "fein": "12-3456789",
    "industry": "technology",
    "number_of_employees": "51-200",
    "organization_legal_type": "llc",
    "doing_business_as": "Acme Plumbing",
    "jurisdiction_of_incorporation": "Delaware",
    "customer_reference": "internal-id-12345",
    "primary_business_domain_sic_code": null,
    "corporate_registration_number": null,
    "professional_license_number": null,
    "dun_bradstreet_number": null,
    "organization_contact": {
      "first_name": "Sam",
      "last_name": "Org",
      "email": "[email protected]",
      "job_title": "Compliance Lead",
      "phone_number": "+13125550000"
    },
    "billing_contact": {
      "first_name": "Alex",
      "last_name": "Bill",
      "email": "[email protected]",
      "phone_number": "+13125550001"
    },
    "organization_physical_address": {
      "country": "US",
      "administrative_area": "IL",
      "city": "Chicago",
      "postal_code": "60601",
      "street_address": "100 Main St",
      "extended_address": "Suite 504"
    },
    "billing_address": {
      "country": "US",
      "administrative_area": "IL",
      "city": "Chicago",
      "postal_code": "60601",
      "street_address": "100 Main St",
      "extended_address": "Suite 504"
    },
    "created_at": "2026-04-26T18:06:51.940749Z",
    "updated_at": "2026-04-26T18:09:24.785211Z",
    "branded_calling_enabled": true,
    "number_reputation_enabled": true,
    "bpo_verification_status": "approved",
    "bpo_verification_rejection_reason": "Business registration document could not be verified."
  }
}

Authorizations

Authorization

string

header

required

Telnyx API key. Generate one at https://portal.telnyx.com/#/app/api-keys.

Path Parameters

enterprise_id

string<uuid>

required

The enterprise id. Lowercase UUID.

Example:

"4a6192a4-573d-446d-b3ce-aff9117272a6"

Response

Branded Calling activated.

data

object

required

Show child attributes

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const response = await client.enterprises.activateBrandedCalling(
  '4a6192a4-573d-446d-b3ce-aff9117272a6',
);

console.log(response.data);

import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
)
response = client.enterprises.activate_branded_calling(
    "4a6192a4-573d-446d-b3ce-aff9117272a6",
)
print(response.data)

package main

import (
	"context"
	"fmt"

	"github.com/team-telnyx/telnyx-go"
	"github.com/team-telnyx/telnyx-go/option"
)

func main() {
	client := telnyx.NewClient(
		option.WithAPIKey("My API Key"),
	)
	response, err := client.Enterprises.ActivateBrandedCalling(context.TODO(), "4a6192a4-573d-446d-b3ce-aff9117272a6")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.Data)
}

package com.telnyx.sdk.example;

import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.enterprises.EnterpriseActivateBrandedCallingParams;
import com.telnyx.sdk.models.enterprises.EnterpriseActivateBrandedCallingResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        TelnyxClient client = TelnyxOkHttpClient.fromEnv();

        EnterpriseActivateBrandedCallingResponse response = client.enterprises().activateBrandedCalling("4a6192a4-573d-446d-b3ce-aff9117272a6");
    }
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');

try {
  $response = $client->enterprises->activateBrandedCalling(
    '4a6192a4-573d-446d-b3ce-aff9117272a6'
  );

  var_dump($response);
} catch (APIException $e) {
  echo $e->getMessage();
}

{
  "data": {
    "id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
    "legal_name": "Acme Plumbing LLC",
    "organization_type": "commercial",
    "country_code": "US",
    "role_type": "enterprise",
    "website": "https://acmeplumbing.example.com",
    "fein": "12-3456789",
    "industry": "technology",
    "number_of_employees": "51-200",
    "organization_legal_type": "llc",
    "doing_business_as": "Acme Plumbing",
    "jurisdiction_of_incorporation": "Delaware",
    "customer_reference": "internal-id-12345",
    "primary_business_domain_sic_code": null,
    "corporate_registration_number": null,
    "professional_license_number": null,
    "dun_bradstreet_number": null,
    "organization_contact": {
      "first_name": "Sam",
      "last_name": "Org",
      "email": "[email protected]",
      "job_title": "Compliance Lead",
      "phone_number": "+13125550000"
    },
    "billing_contact": {
      "first_name": "Alex",
      "last_name": "Bill",
      "email": "[email protected]",
      "phone_number": "+13125550001"
    },
    "organization_physical_address": {
      "country": "US",
      "administrative_area": "IL",
      "city": "Chicago",
      "postal_code": "60601",
      "street_address": "100 Main St",
      "extended_address": "Suite 504"
    },
    "billing_address": {
      "country": "US",
      "administrative_area": "IL",
      "city": "Chicago",
      "postal_code": "60601",
      "street_address": "100 Main St",
      "extended_address": "Suite 504"
    },
    "created_at": "2026-04-26T18:06:51.940749Z",
    "updated_at": "2026-04-26T18:09:24.785211Z",
    "branded_calling_enabled": true,
    "number_reputation_enabled": true,
    "bpo_verification_status": "approved",
    "bpo_verification_rejection_reason": "Business registration document could not be verified."
  }
}