Create a caller identity

A caller identity is what the callee sees: display name, logo and call reasons, backed by a registered business and three references the carrier vetting team phones. It starts in Zernio review (requested). Once approved, the carrier emails the authorizer a 6-digit code; confirm it with the verify-email endpoint and the identity goes into carrier vetting on its own. Track it with GET or the branded_calling.identity.status_updated webhook.

Billing: $100 per identity per month, the first month charged when the identity is filed with the carrier and not refunded if the carrier rejects it, then monthly while the identity exists. Branded calls add $0.10 each, counted on every outbound call from a verified branded number to a US destination (whether or not the callee's carrier displayed the branding); the surcharge shows as brandedCallUSD on the call's billing and in GET /v1/voice/calls/estimate when you pass from.

Run POST /v1/branded-calling/identities/preflight with the same body first to catch what the review would bounce. Send an Idempotency-Key so a retry replays the original response instead of creating a second identity.