Skip to main content
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: {
    administrative_area: 'Illinois',
    city: 'Chicago',
    country: 'United States',
    postal_code: '60601',
    street_address: '123 Main St',
  },
  billing_contact: {
    email: 'billing@acme.com',
    first_name: 'John',
    last_name: 'Doe',
    phone_number: '15551234568',
  },
  country_code: 'US',
  doing_business_as: 'Acme',
  fein: '12-3456789',
  industry: 'technology',
  legal_name: 'Acme Corp Inc.',
  number_of_employees: '51-200',
  organization_contact: {
    email: 'jane.smith@acme.com',
    first_name: 'Jane',
    job_title: 'VP of Engineering',
    last_name: 'Smith',
    phone: '+16035551234',
  },
  organization_legal_type: 'corporation',
  organization_physical_address: {
    administrative_area: 'Illinois',
    city: 'Chicago',
    country: 'United States',
    postal_code: '60601',
    street_address: '123 Main St',
  },
  organization_type: 'commercial',
  website: 'https://acme.com',
});

console.log(enterprise.data);
{
  "data": {
    "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    "legal_name": "Acme Corp Inc.",
    "doing_business_as": "Acme",
    "organization_type": "commercial",
    "country_code": "US",
    "role_type": "enterprise",
    "customer_reference": "<string>",
    "website": "<string>",
    "fein": "<string>",
    "industry": "<string>",
    "number_of_employees": "1-10",
    "organization_legal_type": "corporation",
    "primary_business_domain_sic_code": "<string>",
    "corporate_registration_number": "<string>",
    "professional_license_number": "<string>",
    "dun_bradstreet_number": "<string>",
    "organization_contact": {
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane.smith@acme.com",
      "job_title": "VP of Engineering",
      "phone": "+16035551234"
    },
    "billing_contact": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "billing@acme.com",
      "phone_number": "15551234568"
    },
    "organization_physical_address": {
      "country": "United States",
      "administrative_area": "Illinois",
      "city": "Chicago",
      "postal_code": "60601",
      "street_address": "123 Main St",
      "extended_address": "Suite 400"
    },
    "billing_address": {
      "country": "United States",
      "administrative_area": "Illinois",
      "city": "Chicago",
      "postal_code": "60601",
      "street_address": "123 Main St",
      "extended_address": "Suite 400"
    },
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

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 Corp Inc."

​
doing_business_as
string
required

Primary business name / DBA name

Maximum string length: 255
Example:

"Acme"

​
organization_type
enum<string>
required

Type of organization

Available options:
commercial,
government,
non_profit
Example:

"commercial"

​
country_code
string
required

Country code. Currently only 'US' is accepted.

Required string length: 2
Example:

"US"

​
website
string
required

Enterprise website URL. Accepts any string — no URL format validation enforced.

Maximum string length: 255
Example:

"https://acme.com"

​
fein
string
required

Federal Employer Identification Number. Format: XX-XXXXXXX or 9-digit number (minimum 9 digits).

Maximum string length: 20
Example:

"12-3456789"

​
industry
string
required

Industry classification. Case-insensitive. Accepted values: 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

Employee count range

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 structure type

Available options:
corporation,
llc,
partnership,
nonprofit,
other
Example:

"corporation"

​
organization_contact
object
required

Organization contact information. Note: the response returns this object with the phone field as 'phone' (not 'phone_number').

​
billing_contact
object
required
​
organization_physical_address
object
required
​
billing_address
object
required
​
role_type
enum<string>
default:enterprise

Role type in Branded Calling / Number Reputation services

Available options:
enterprise,
bpo
​
primary_business_domain_sic_code
string

SIC Code (optional)

Maximum string length: 10
Example:

"7372"

​
corporate_registration_number
string

Corporate registration number (optional)

Maximum string length: 100
​
professional_license_number
string

Professional license number (optional)

Maximum string length: 100
​
dun_bradstreet_number
string

D-U-N-S Number (optional)

Maximum string length: 20
​
customer_reference
string

Optional customer reference identifier for your own tracking

Maximum string length: 255

Response

Enterprise created successfully

​
data
object