Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Telnyx Brands API

Brand operations

Telnyx Brands API is one of 168 APIs that Telnyx publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Brands. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 15 operations across 8 paths, and defines 27 schemas. It is described by OpenAPI 3.1.0, at version 2.0.0.

Requests are made against a single base URL, https://api.telnyx.com/v2.

15 operations 8 paths 27 schemas 1 DELETE6 GET4 POST4 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.0.0
Base URL
https://api.telnyx.com/v2
Authentication
HTTP Bearer, HTTP Bearer, OAuth 2.0, HTTP Bearer, HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 6

Telnyx Brands API declares 6 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). It accepts HTTP bearer tokens (branded-calling_bearerAuth). It supports OAuth 2.0 (oauthClientAuth) using the authorizationCode and clientCredentials flows, exposing 1 scope. It accepts HTTP bearer tokens (JWT) (outbound-voice-profiles_bearerAuth). It accepts HTTP bearer tokens (pronunciation-dicts_bearerAuth). It accepts HTTP bearer tokens (JWT) (stored-payment-transactions_bearerAuth). By default, every request must be authenticated.

  • branded-calling_bearerAuth — API key passed as a Bearer token in the Authorization header
  • oauthClientAuth — OAuth 2.0 authentication for Telnyx API and MCP integrations
  • pronunciation-dicts_bearerAuth — Telnyx API v2 key. Obtain from https://portal.telnyx.com

Paths & Operations 15

Across 8 paths, the API surfaces 15 operations — 1 DELETE, 6 GET, 4 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

Brands 15

Brand operations

GET
/10dlc/brand
List Brands
GetBrands 9 params → 2004XX
POST
/10dlc/brand
Create Brand
CreateBrandPost body → 2004224XX
GET
/10dlc/brand/feedback/{brandId}
Get Brand Feedback By Id
GetBrandFeedbackById 1 param → 2004224XX
GET
/10dlc/brand/smsOtp/{referenceId}
Get Brand SMS OTP Status
GetBrandSmsOtpStatus 2 params → 2004044224XX
DELETE
/10dlc/brand/{brandId}
Delete Brand
DeleteBrand 1 param → 2044004044224XX
GET
/10dlc/brand/{brandId}
Get Brand
GetBrand 1 param → 2004224XX
PUT
/10dlc/brand/{brandId}
Update Brand
UpdateBrand 1 param body → 2004224XX
POST
/10dlc/brand/{brandId}/2faEmail
Resend brand 2FA email
ResendBrand2faEmail 1 param → 2004XX
GET
/10dlc/brand/{brandId}/externalVetting
List External Vettings
ListExternalVettings 1 param → 2004224XX
POST
/10dlc/brand/{brandId}/externalVetting
Order Brand External Vetting
PostOrderExternalVetting 1 param body → 2004224XX
PUT
/10dlc/brand/{brandId}/externalVetting
Import External Vetting Record
PutExternalVettingRecord 1 param body → 2004224XX
PUT
/10dlc/brand/{brandId}/revet
Revet Brand
RevetBrand 1 param → 2004224XX
GET
/10dlc/brand/{brandId}/smsOtp
Get Brand SMS OTP Status by Brand ID
GetBrandSmsOtpStatusByBrandId 1 param → 2004044224XX
POST
/10dlc/brand/{brandId}/smsOtp
Trigger Brand SMS OTP
TriggerBrandSmsOtp 1 param body → 2004004224XX
PUT
/10dlc/brand/{brandId}/smsOtp
Verify Brand SMS OTP
VerifyBrandSmsOtp 1 param body → 2044004224XX

Schemas 27

The contract defines 27 schemas that model the data the API accepts and returns. The most detailed are TelnyxBrand (38 properties), UpdateBrand (25 properties), CreateBrand (24 properties), BrandBasic (13 properties). Each schema is shown below with its type and property counts.

10dlc_Error
object
4 properties 2 required
ImportExternalVetting
object
3 properties 2 required
CreateBrand
object
24 properties 5 required
TelnyxBrandWithCampaignsCount
ValidationError
object
3 properties 3 required
BrandIdentityStatus
string
The verification status of an active brand
StockExchange
string
(Required for public company) stock exchange.
HTTPValidationError
object
1 property
EntityType
string
Entity type behind the brand. This is the form of business establishment.
TriggerBrandSmsOtpRequest
object
Request body for triggering a Brand SMS OTP
2 properties 2 required
10dlc_Errors
object
1 property
ExternalVetting
object
7 properties
BrandRelationship
string
Brand relationship to the CSP.
BrandFeedback
object
2 properties 2 required
UpdateBrand
object
25 properties 5 required
BrandOptionalAttributes
object
1 property
ExternalVettingList
array
AltBusinessIdType
string
An enumeration.
VerifyBrandSmsOtpRequest
object
Request body for verifying a Brand SMS OTP
1 property 1 required
BrandFeedbackCategory
object
4 properties 4 required
OrderExternalVetting
object
2 properties 2 required
Vertical
string
Vertical or industry segment of the brand or campaign.
BrandRecordSetCSP
object
3 properties
TelnyxBrand
object
Telnyx-specific extensions to The Campaign Registry's Brand type
38 properties 6 required
TriggerBrandSmsOtpResponse
object
Response after successfully triggering a Brand SMS OTP
2 properties 2 required
BrandSmsOtpStatus
object
Status information for an SMS OTP sent during Sole Proprietor brand verification
8 properties 5 required
BrandBasic
object
13 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

telnyx-brands-api-openapi.yml Raw ↑

Other APIs Telnyx publishes across the network.

Telnyx Access Tokens API
Telnyx Addresses API
Telnyx Advanced Number Orders API
Telnyx Assistants API
Telnyx Audio API
Telnyx Audit Logs API
Telnyx Authentication Providers API
Telnyx AutoRechargePreferences API
Telnyx Billing API
Telnyx Billing Groups API
Telnyx Bucket SSL Certificate API
Telnyx Bucket Usage API