Sign in

v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Enterprises

Create an enterprise

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.
post/enterprises

Request body

corporate_registration_numberstring nullable

Optional corporate-registration / company-number identifier.

country_codestring required

ISO 3166-1 alpha-2 country code. Currently US and CA are supported.

customer_referencestring

Optional free-form string the caller can attach for their own bookkeeping. Telnyx does not interpret it.

doing_business_asstring required
dun_bradstreet_numberstring nullable

Optional D-U-N-S Number.

feinstring 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_incorporationstring required
legal_namestring 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_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_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_codestring nullable

Optional SIC code for the primary line of business.

professional_license_numberstring 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.

websitestring uri required

Example request

{
  "billing_address": {
    "administrative_area": "IL",
    "city": "Chicago",
    "country": "US",
    "extended_address": "Suite 504",
    "postal_code": "60601",
    "street_address": "100 Main St"
  },
  "billing_contact": {
    "email": "billing@acmeplumbing.example.com",
    "first_name": "Alex",
    "last_name": "Bill",
    "phone_number": "+13125550001"
  },
  "country_code": "US",
  "customer_reference": "internal-id-12345",
  "doing_business_as": "Acme Plumbing",
  "fein": "12-3456789",
  "industry": "technology",
  "jurisdiction_of_incorporation": "Delaware",
  "legal_name": "Acme Plumbing LLC",
  "number_of_employees": "51-200",
  "organization_contact": {
    "email": "sam@acmeplumbing.example.com",
    "first_name": "Sam",
    "job_title": "Compliance Lead",
    "last_name": "Org",
    "phone_number": "+13125550000"
  },
  "organization_legal_type": "llc",
  "organization_physical_address": {
    "administrative_area": "IL",
    "city": "Chicago",
    "country": "US",
    "extended_address": "Suite 504",
    "postal_code": "60601",
    "street_address": "100 Main St"
  },
  "organization_type": "commercial",
  "role_type": "enterprise",
  "website": "https://acmeplumbing.example.com"
}

Response

Enterprise created.

Example response

{
  "data": {
    "billing_address": {
      "administrative_area": "IL",
      "city": "Chicago",
      "country": "US",
      "extended_address": "Suite 504",
      "postal_code": "60601",
      "street_address": "100 Main St"
    },
    "billing_contact": {
      "email": "billing@acmeplumbing.example.com",
      "first_name": "Alex",
      "last_name": "Bill",
      "phone_number": "+13125550001"
    },
    "country_code": "US",
    "created_at": "2026-04-26T18:06:51.940749Z",
    "customer_reference": "internal-id-12345",
    "doing_business_as": "Acme Plumbing",
    "fein": "12-3456789",
    "id": "4a6192a4-573d-446d-b3ce-aff9117272a6",
    "industry": "technology",
    "jurisdiction_of_incorporation": "Delaware",
    "legal_name": "Acme Plumbing LLC",
    "number_of_employees": "51-200",
    "organization_contact": {
      "email": "sam@acmeplumbing.example.com",
      "first_name": "Sam",
      "job_title": "Compliance Lead",
      "last_name": "Org",
      "phone_number": "+13125550000"
    },
    "organization_legal_type": "llc",
    "organization_physical_address": {
      "administrative_area": "IL",
      "city": "Chicago",
      "country": "US",
      "extended_address": "Suite 504",
      "postal_code": "60601",
      "street_address": "100 Main St"
    },
    "organization_type": "commercial",
    "role_type": "enterprise",
    "updated_at": "2026-04-26T18:09:24.785211Z",
    "website": "https://acmeplumbing.example.com"
  }
}