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

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const enterprise = await client.enterprises.create({
  billing_address: {
    country: 'US',
    administrative_area: 'IL',
    city: 'Chicago',
    postal_code: '60601',
    street_address: '100 Main St',
  },
  billing_contact: {
    first_name: 'Alex',
    last_name: 'Bill',
    email: 'billing@run065.example.com',
    phone_number: '+13125550001',
  },
  country_code: 'US',
  doing_business_as: 'Run 065 Debug',
  fein: '12-3456789',
  industry: 'technology',
  jurisdiction_of_incorporation: 'Delaware',
  legal_name: 'Run 065 Debug Co',
  number_of_employees: '51-200',
  organization_contact: {
    first_name: 'Sam',
    last_name: 'Org',
    email: 'org@run065.example.com',
    job_title: 'Compliance Lead',
    phone_number: '+13125550000',
  },
  organization_legal_type: 'llc',
  organization_physical_address: {
    country: 'US',
    administrative_area: 'IL',
    city: 'Chicago',
    postal_code: '60601',
    street_address: '100 Main St',
  },
  organization_type: 'commercial',
  website: 'https://run065.example.com',
  role_type: 'enterprise',
});

console.log(enterprise.data);

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

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

legal_name

string

required

Legal name of the enterprise.

Required string length: 3 - 64

Example:

"Acme Plumbing LLC"

organization_type

enum<string>

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

Available options:

commercial,

government,

non_profit

Example:

"commercial"

country_code

string

required

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

Example:

"US"

website

string<uri>

required

Maximum string length: 255

Example:

"https://acmeplumbing.example.com"

fein

string

required

US Federal Employer Identification Number (NN-NNNNNNN) or Canadian equivalent.

Example:

"12-3456789"

industry

enum<string>

required

Industry classification.

Available options:

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

Example:

"technology"

number_of_employees

enum<string>

required

Approximate headcount range. Used for vetting heuristics; pick the bucket that contains your current employee count.

Available options:

1-10,

11-50,

51-200,

201-500,

501-2000,

2001-10000,

10001+

Example:

"51-200"

organization_legal_type

enum<string>

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.

Available options:

corporation,

llc,

partnership,

nonprofit,

other

Example:

"llc"

doing_business_as

string

required

Maximum string length: 255

Example:

"Acme Plumbing"

jurisdiction_of_incorporation

string

required

Maximum string length: 255

Example:

"Delaware"

organization_contact

object

required

Show child attributes

billing_contact

object

required

Show child attributes

organization_physical_address

object

required

Show child attributes

billing_address

object

required

Show child attributes

role_type

enum<string>

default:enterprise

enterprise for an organization registering its own DIRs; bpo for a Business Process Outsourcer placing calls on behalf of one or more enterprises.

Available options:

enterprise,

bpo

Example:

"enterprise"

customer_reference

string

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

Maximum string length: 255

Example:

"internal-id-12345"

primary_business_domain_sic_code

string | null

Optional SIC code for the primary line of business.

corporate_registration_number

string | null

Optional corporate-registration / company-number identifier.

professional_license_number

string | null

Optional professional-license number for regulated industries.

dun_bradstreet_number

string | null

Optional D-U-N-S Number.

Response

Enterprise created.

data

object

required

Show child attributes

List enterprises

Get an enterprise

⌘I

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const enterprise = await client.enterprises.create({
  billing_address: {
    country: 'US',
    administrative_area: 'IL',
    city: 'Chicago',
    postal_code: '60601',
    street_address: '100 Main St',
  },
  billing_contact: {
    first_name: 'Alex',
    last_name: 'Bill',
    email: 'billing@run065.example.com',
    phone_number: '+13125550001',
  },
  country_code: 'US',
  doing_business_as: 'Run 065 Debug',
  fein: '12-3456789',
  industry: 'technology',
  jurisdiction_of_incorporation: 'Delaware',
  legal_name: 'Run 065 Debug Co',
  number_of_employees: '51-200',
  organization_contact: {
    first_name: 'Sam',
    last_name: 'Org',
    email: 'org@run065.example.com',
    job_title: 'Compliance Lead',
    phone_number: '+13125550000',
  },
  organization_legal_type: 'llc',
  organization_physical_address: {
    country: 'US',
    administrative_area: 'IL',
    city: 'Chicago',
    postal_code: '60601',
    street_address: '100 Main St',
  },
  organization_type: 'commercial',
  website: 'https://run065.example.com',
  role_type: 'enterprise',
});

console.log(enterprise.data);

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