Branded Calling

Branded Calling is currently in beta. We’re rolling it out gradually, so some features may not be fully available yet and behavior can change while we finalize the product. The exact information displayed on the recipient’s phone depends on many factors (carrier network, device manufacturer, device type, OS version, etc.). If something doesn’t work exactly as documented, it’s most likely still being enabled, and we appreciate your patience as we get everything ready. For the latest on availability and how branded calls are delivered, see Making calls with Branded Calling. This feature is currently supported in the US only.

Overview

Branded Calling displays your verified business identity on the recipient’s phone screen before they answer. Instead of seeing a bare phone number, or worse, “Spam Likely”, recipients see your business name, logo, and the reason for your call. The screenshots below show Branded Calling in action.

How it works

You register your business as an Enterprise and create a display identity (Display Identity Record) with your name, logo, and call reason.
Telnyx vets the DIR, verifying your business identity, IP ownership, and compliance.
You associate your Telnyx phone numbers with the verified DIR.
When you place a call from those numbers, Telnyx automatically signs the call with a cryptographic token (SHAKEN PASSporT) containing your DIR’s rich call data.
The terminating carrier verifies the signature and renders your DIR info on the recipient’s device.

Resource hierarchy

Enterprise (your organization, registered once)
├── Display Identity Record (DIR, the display identity)
│   ├── Phone-number Batch (the unit of carrier-network vetting)
│   │   ├── Phone Number (+15551234567)
│   │   └── Phone Number (+15559876543)
│   └── Call Reasons ["Customer Service", "Appointment Reminder"]
├── Display Identity Record (DIR, another identity)
│   └── Phone-number Batch
│       └── Phone Number (+15550001111)
└── Terms of Service Agreement (Branded Calling)

An Enterprise can have multiple Display Identity Records (DIRs).
Each Display Identity Record has its own display name, logo, call reasons, and phone numbers.
A Phone Number belongs to exactly one Display Identity Record.
Phone numbers are added in batches: each POST creates one batch, and the batch is the unit that goes through carrier-network vetting.
Call reasons are set at the Display Identity Record level.

Key concepts

Term	Description
Enterprise	Your top-level business registration. Required before creating DIRs.
Display Identity Record (DIR)	Defines what recipients see (name, logo, call reason).
Vetting	The verification process that validates your DIR identity and business information.
Call Reason	Text shown to recipients explaining why you’re calling (e.g. “Appointment Reminder”).

Ecosystem

Branded Calling is built on an industry-wide registry, managed by CTIA. The registry ensures trust among all participants through common technical and governance frameworks. Telnyx handles all ecosystem interactions on your behalf, you interact only with the Telnyx API.

Next steps

Quickstart guide, get your first branded call working
Pricing, Branded Calling pricing details
Display Identity Records, create and manage display identities
Phone Numbers, associate numbers with DIRs
Call Reasons, configure what recipients see
Infringement Claims, what to do if a claim is filed against your DIR

​Overview

​How it works

​Resource hierarchy

​Key concepts

​Ecosystem

​Next steps