---
title: "Create an enterprise"
method: POST
path: "/enterprises"
tags: ["Enterprises"]
---

# Create an enterprise

`POST /enterprises`

Create the legal entity (enterprise) that represents your business on the Telnyx platform.

The response carries a server-assigned `id` you use for every subsequent call. An enterprise is created once and reused; the API collects all required fields up front.

Common failure modes:
- `422` - a required field is missing or malformed (the response `errors[].source.pointer` names the field).
- `409` - an enterprise with the same identifying details already exists under your account.

## Request body

- EnterpriseCreate
  - `billing_address` BillingAddress, required
    - `administrative_area` string, required — State or province code (e.g. `IL`, `ON`).
    - `city` string, required
    - `country` string, required — ISO 3166-1 alpha-2 code (currently `US` or `CA`).
    - `extended_address` string, nullable
    - `postal_code` string, required
    - `street_address` string, required
  - `billing_contact` BillingContact, required
    - `email` string, email, required
    - `first_name` string, required
    - `last_name` string, required
    - `phone_number` string, required — E.164 format with leading `+`.
  - `corporate_registration_number` string, nullable — Optional corporate-registration / company-number identifier.
  - `country_code` string, required — ISO 3166-1 alpha-2 country code. Currently `US` and `CA` are supported.
  - `customer_reference` string — Optional free-form string the caller can attach for their own bookkeeping. Telnyx does not interpret it.
  - `doing_business_as` string, required
  - `dun_bradstreet_number` string, nullable — Optional D-U-N-S Number.
  - `fein` string, required — US Federal Employer Identification Number (`NN-NNNNNNN`) or Canadian equivalent.
  - `industry` 'accounting' | 'finance' | 'billing' | 'collections' | 'business' | 'charity' | 'nonprofit' | 'communications' | 'telecom' | 'customer service' | 'support' | 'delivery' | 'shipping' | 'logistics' | 'education' | 'financial' | 'banking' | 'government' | 'public' | 'healthcare' | 'health' | 'pharmacy' | 'medical' | 'insurance' | 'legal' | 'law' | 'notifications' | 'scheduling' | 'real estate' | 'property' | 'retail' | 'ecommerce' | 'sales' | 'marketing' | 'software' | 'technology' | 'tech' | 'media' | 'surveys' | 'market research' | 'travel' | 'hospitality' | 'hotel', required — Industry classification.
  - `jurisdiction_of_incorporation` string, required
  - `legal_name` string, required — Legal name of the enterprise.
  - `number_of_employees` '1-10' | '11-50' | '51-200' | '201-500' | '501-2000' | '2001-10000' | '10001+', required — Approximate headcount range. Used for vetting heuristics; pick the bucket that contains your current employee count.
  - `organization_contact` OrganizationContact, required
    - `email` string, email, required
    - `first_name` string, required
    - `job_title` string, required
    - `last_name` string, required
    - `phone_number` string, required — E.164 format with leading `+`.
  - `organization_legal_type` 'corporation' | 'llc' | 'partnership' | 'nonprofit' | 'other', required — Legal-entity form. Pick the form that matches your incorporation documents: - `corporation` - C-corp or S-corp. - `llc` - limited liability company. - `partnership` - general/limited partnership. - `nonprofit` - non-profit corporation, charitable trust, or 501(c)(3)/equivalent. - `other` - anything else (sole proprietorships, government bodies, DBAs, etc.). You may be asked for additional documents during vetting.
  - `organization_physical_address` PhysicalAddress, required
    - `administrative_area` string, required — State or province code (e.g. `IL`, `ON`).
    - `city` string, required
    - `country` string, required — ISO 3166-1 alpha-2 code (currently `US` or `CA`).
    - `extended_address` string, nullable
    - `postal_code` string, required
    - `street_address` string, required
  - `organization_type` 'commercial' | 'government' | 'non_profit', required — Organization category for vetting purposes: - `commercial` - for-profit business entities (LLC, corp, partnership, sole proprietorship). Most callers fall here. - `government` - federal/state/local government bodies. - `non_profit` - registered 501(c)(3)/equivalent (incl. educational institutions, charities, religious organisations).
  - `primary_business_domain_sic_code` string, nullable — Optional SIC code for the primary line of business.
  - `professional_license_number` string, nullable — Optional professional-license number for regulated industries.
  - `role_type` 'enterprise' | 'bpo' — `enterprise` for an organization registering its own DIRs; `bpo` for a Business Process Outsourcer placing calls on behalf of one or more enterprises.
  - `website` string, uri, required

## Response `201`

Enterprise created.

- EnterprisePublicWrapped
  - `data` EnterprisePublic, required
    - `billing_address` BillingAddress
      - `administrative_area` string, required — State or province code (e.g. `IL`, `ON`).
      - `city` string, required
      - `country` string, required — ISO 3166-1 alpha-2 code (currently `US` or `CA`).
      - `extended_address` string, nullable
      - `postal_code` string, required
      - `street_address` string, required
    - `billing_contact` BillingContact
      - `email` string, email, required
      - `first_name` string, required
      - `last_name` string, required
      - `phone_number` string, required — E.164 format with leading `+`.
    - `branded_calling_enabled` boolean — True once Branded Calling has been activated on this enterprise (see `POST /enterprises/{id}/branded_calling`).
    - `corporate_registration_number` string, nullable — Optional corporate-registration / company-number identifier.
    - `country_code` string
    - `created_at` string, date-time
    - `customer_reference` string
    - `doing_business_as` string
    - `dun_bradstreet_number` string, nullable — Optional D-U-N-S Number issued by Dun & Bradstreet.
    - `fein` string
    - `id` string, uuid
    - `industry` string
    - `jurisdiction_of_incorporation` string
    - `legal_name` string
    - `number_of_employees` string
    - `number_reputation_enabled` boolean — True once Phone Number Reputation has been enabled on this enterprise (see `POST /enterprises/{id}/reputation`).
    - `organization_contact` OrganizationContact
      - `email` string, email, required
      - `first_name` string, required
      - `job_title` string, required
      - `last_name` string, required
      - `phone_number` string, required — E.164 format with leading `+`.
    - `organization_legal_type` string
    - `organization_physical_address` PhysicalAddress
      - `administrative_area` string, required — State or province code (e.g. `IL`, `ON`).
      - `city` string, required
      - `country` string, required — ISO 3166-1 alpha-2 code (currently `US` or `CA`).
      - `extended_address` string, nullable
      - `postal_code` string, required
      - `street_address` string, required
    - `organization_type` string
    - `primary_business_domain_sic_code` string, nullable — Optional SIC code for the primary line of business.
    - `professional_license_number` string, nullable — Optional professional-license number for regulated industries.
    - `role_type` string
    - `updated_at` string, date-time
    - `website` string

## Other responses

- `400` — An error occurred. The response carries the standard Telnyx error envelope.
- `401` — An error occurred. The response carries the standard Telnyx error envelope.
- `422` — An error occurred. The response carries the standard Telnyx error envelope.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/1571b0380bd7/schema)