The Branded Calling API is coming soon. These endpoints are under active development and will be available in an upcoming release.
What’s coming
The Branded Calling API will let you programmatically manage your Display Identity Record (DIR), which controls how your business appears on recipients’ screens when you place outbound calls.
Planned endpoints
| Method | Path | Description |
|---|
GET | /v1/caller-trust/brand | Retrieve your current DIR draft and approval status |
PUT | /v1/caller-trust/brand | Create or update your DIR draft (display name, call reason) |
POST | /v1/caller-trust/brand/submit | Submit your completed DIR for carrier review |
DIR fields
| Field | Requirements |
|---|
| Display name | Your legal business name, up to 64 characters |
| Call reason | Brief description of why you’re calling, up to 120 characters |
| Logo | Square image (PNG, JPEG, or WebP), minimum 200 x 200 px |
To learn more about how Branded Calling works, see the Caller Trust guide.