---
title: "Register a business for Branded Calling"
method: POST
path: "/v1/branded-calling/enterprises"
tags: ["Branded Calling"]
---

# Register a business for Branded Calling

`POST /v1/branded-calling/enterprises`

Stores the legal entity behind your caller identities. Nothing is filed with the
carrier until the business's first identity passes review. Only businesses
registered in the US or Canada qualify (a FEIN or Canadian equivalent is
required); any other country returns `422`. Send an `Idempotency-Key` so a
retry replays the original response instead of registering the business twice.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `legalName` string, required — Exactly as on the tax record.
  - `doingBusinessAs` string, required
  - `organizationType` 'commercial' | 'government' | 'non_profit', required
  - `organizationLegalType` 'corporation' | 'llc' | 'partnership' | 'nonprofit' | 'other', required
  - `countryCode` string, required — ISO 3166-1 alpha-2. US or CA.
  - `jurisdictionOfIncorporation` string, required — State, province or country of registration.
  - `website` string, uri, required
  - `fein` string, required — US Federal Employer Identification Number (NN-NNNNNNN) or the Canadian equivalent. Stored encrypted; only the last four digits are ever returned.
  - `industry` string, required — One of the carrier industry labels, e.g. technology, healthcare, retail, finance, legal, insurance, real estate, logistics, education.
  - `numberOfEmployees` '1-10' | '11-50' | '51-200' | '201-500' | '501-2000' | '2001-10000' | '10001+', required
  - `organizationContact` BrandedCallingContact, required
    - `firstName` string, required
    - `lastName` string, required
    - `email` string, email, required
    - `jobTitle` string — Required on organizationContact.
    - `phoneNumber` string, required — E.164 with a leading +.
  - `billingContact` BrandedCallingContact, required
    - `firstName` string, required
    - `lastName` string, required
    - `email` string, email, required
    - `jobTitle` string — Required on organizationContact.
    - `phoneNumber` string, required — E.164 with a leading +.
  - `physicalAddress` BrandedCallingAddress, required
    - `streetAddress` string, required
    - `extendedAddress` string
    - `city` string, required
    - `administrativeArea` string, required — State or province code (IL, ON).
    - `postalCode` string, required
    - `country` string, required — ISO 3166-1 alpha-2 (US or CA).
  - `billingAddress` BrandedCallingAddress, required
    - `streetAddress` string, required
    - `extendedAddress` string
    - `city` string, required
    - `administrativeArea` string, required — State or province code (IL, ON).
    - `postalCode` string, required
    - `country` string, required — ISO 3166-1 alpha-2 (US or CA).

## Response `201`

Business stored.

- BrandedCallingEnterprise
  - `id` string
  - `legalName` string
  - `doingBusinessAs` string
  - `organizationType` 'commercial' | 'government' | 'non_profit'
  - `organizationLegalType` 'corporation' | 'llc' | 'partnership' | 'nonprofit' | 'other'
  - `countryCode` 'US' | 'CA'
  - `jurisdictionOfIncorporation` string
  - `website` string
  - `feinLast4` string — Last four digits of the tax id; the full id is never returned.
  - `industry` string
  - `numberOfEmployees` '1-10' | '11-50' | '51-200' | '201-500' | '501-2000' | '2001-10000' | '10001+'
  - `organizationContact` BrandedCallingContact
    - `firstName` string, required
    - `lastName` string, required
    - `email` string, email, required
    - `jobTitle` string — Required on organizationContact.
    - `phoneNumber` string, required — E.164 with a leading +.
  - `billingContact` BrandedCallingContact
    - `firstName` string, required
    - `lastName` string, required
    - `email` string, email, required
    - `jobTitle` string — Required on organizationContact.
    - `phoneNumber` string, required — E.164 with a leading +.
  - `physicalAddress` BrandedCallingAddress
    - `streetAddress` string, required
    - `extendedAddress` string
    - `city` string, required
    - `administrativeArea` string, required — State or province code (IL, ON).
    - `postalCode` string, required
    - `country` string, required — ISO 3166-1 alpha-2 (US or CA).
  - `billingAddress` BrandedCallingAddress
    - `streetAddress` string, required
    - `extendedAddress` string
    - `city` string, required
    - `administrativeArea` string, required — State or province code (IL, ON).
    - `postalCode` string, required
    - `country` string, required — ISO 3166-1 alpha-2 (US or CA).
  - `registered` boolean — True once the business exists at the carrier (happens when its first identity passes review).
  - `createdAt` string, date-time, nullable

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `409` — Same Idempotency-Key still processing; retry after a short backoff
- `422` — The business is not registered in the US or Canada (code feature_not_available), or the Idempotency-Key was reused with a different body (code idempotency_key_reused).

## Changes

- **2026-09-30** `16a7b9d5373e` — 1 info
  - removed the `platform` enum value from the `details/budgetScope` response property for the response status `400`
- **2026-09-29** `698a0d89ab62` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/branded-calling/enterprises/post.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/f92af0e169c1?raw)