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 responseerrors[].source.pointernames 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: '[email protected]',
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: '[email protected]',
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);import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
enterprise = 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": "[email protected]",
"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": "[email protected]",
"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",
)
print(enterprise.data)
package main
import (
"context"
"fmt"
"github.com/team-telnyx/telnyx-go"
"github.com/team-telnyx/telnyx-go/option"
)
func main() {
client := telnyx.NewClient(
option.WithAPIKey("My API Key"),
)
enterprise, err := client.Enterprises.New(context.TODO(), telnyx.EnterpriseNewParams{
BillingAddress: telnyx.BillingAddressParam{
Country: "US",
AdministrativeArea: "IL",
City: "Chicago",
PostalCode: "60601",
StreetAddress: "100 Main St",
},
BillingContact: telnyx.BillingContactParam{
FirstName: "Alex",
LastName: "Bill",
Email: "[email protected]",
PhoneNumber: "+13125550001",
},
CountryCode: "US",
DoingBusinessAs: "Run 065 Debug",
Fein: "12-3456789",
Industry: telnyx.EnterpriseNewParamsIndustryTechnology,
JurisdictionOfIncorporation: "Delaware",
LegalName: "Run 065 Debug Co",
NumberOfEmployees: telnyx.EnterpriseNewParamsNumberOfEmployeesNumberOfEmployees51_200,
OrganizationContact: telnyx.OrganizationContactParam{
FirstName: "Sam",
LastName: "Org",
Email: "[email protected]",
JobTitle: "Compliance Lead",
PhoneNumber: "+13125550000",
},
OrganizationLegalType: telnyx.EnterpriseNewParamsOrganizationLegalTypeLlc,
OrganizationPhysicalAddress: telnyx.PhysicalAddressParam{
Country: "US",
AdministrativeArea: "IL",
City: "Chicago",
PostalCode: "60601",
StreetAddress: "100 Main St",
},
OrganizationType: telnyx.EnterpriseNewParamsOrganizationTypeCommercial,
Website: "https://run065.example.com",
RoleType: telnyx.EnterpriseNewParamsRoleTypeEnterprise,
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", enterprise.Data)
}
package com.telnyx.sdk.example;
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.enterprises.BillingAddress;
import com.telnyx.sdk.models.enterprises.BillingContact;
import com.telnyx.sdk.models.enterprises.EnterpriseCreateParams;
import com.telnyx.sdk.models.enterprises.EnterpriseCreateResponse;
import com.telnyx.sdk.models.enterprises.OrganizationContact;
import com.telnyx.sdk.models.enterprises.PhysicalAddress;
public final class Main {
private Main() {}
public static void main(String[] args) {
TelnyxClient client = TelnyxOkHttpClient.fromEnv();
EnterpriseCreateParams params = EnterpriseCreateParams.builder()
.billingAddress(BillingAddress.builder()
.administrativeArea("IL")
.city("Chicago")
.country("US")
.postalCode("60601")
.streetAddress("100 Main St")
.build())
.billingContact(BillingContact.builder()
.email("[email protected]")
.firstName("Alex")
.lastName("Bill")
.phoneNumber("+13125550001")
.build())
.countryCode("US")
.doingBusinessAs("Run 065 Debug")
.fein("12-3456789")
.industry(EnterpriseCreateParams.Industry.TECHNOLOGY)
.jurisdictionOfIncorporation("Delaware")
.legalName("Run 065 Debug Co")
.numberOfEmployees(EnterpriseCreateParams.NumberOfEmployees.NUMBER_OF_EMPLOYEES_51_200)
.organizationContact(OrganizationContact.builder()
.email("[email protected]")
.firstName("Sam")
.jobTitle("Compliance Lead")
.lastName("Org")
.phoneNumber("+13125550000")
.build())
.organizationLegalType(EnterpriseCreateParams.OrganizationLegalType.LLC)
.organizationPhysicalAddress(PhysicalAddress.builder()
.administrativeArea("IL")
.city("Chicago")
.country("US")
.postalCode("60601")
.streetAddress("100 Main St")
.build())
.organizationType(EnterpriseCreateParams.OrganizationType.COMMERCIAL)
.website("https://run065.example.com")
.build();
EnterpriseCreateResponse enterprise = client.enterprises().create(params);
}
}require "telnyx"
telnyx = Telnyx::Client.new(api_key: "My API Key")
enterprise = telnyx.enterprises.create(
billing_address: {administrative_area: "IL", city: "Chicago", country: "US", postal_code: "60601", street_address: "100 Main St"},
billing_contact: {email: "[email protected]", first_name: "Alex", last_name: "Bill", 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: {
email: "[email protected]",
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", postal_code: "60601", street_address: "100 Main St"},
organization_type: :commercial,
website: "https://run065.example.com"
)
puts(enterprise)<?php
require_once dirname(__DIR__) . '/vendor/autoload.php';
use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;
$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');
try {
$enterprise = $client->enterprises->create(
billingAddress: [
'administrativeArea' => 'IL',
'city' => 'Chicago',
'country' => 'US',
'postalCode' => '60601',
'streetAddress' => '100 Main St',
'extendedAddress' => 'Suite 504',
],
billingContact: [
'email' => '[email protected]',
'firstName' => 'Alex',
'lastName' => 'Bill',
'phoneNumber' => '+13125550001',
],
countryCode: 'US',
doingBusinessAs: 'Run 065 Debug',
fein: '12-3456789',
industry: 'technology',
jurisdictionOfIncorporation: 'Delaware',
legalName: 'Run 065 Debug Co',
numberOfEmployees: '51-200',
organizationContact: [
'email' => '[email protected]',
'firstName' => 'Sam',
'jobTitle' => 'Compliance Lead',
'lastName' => 'Org',
'phoneNumber' => '+13125550000',
],
organizationLegalType: 'llc',
organizationPhysicalAddress: [
'administrativeArea' => 'IL',
'city' => 'Chicago',
'country' => 'US',
'postalCode' => '60601',
'streetAddress' => '100 Main St',
'extendedAddress' => 'Suite 504',
],
organizationType: 'commercial',
website: 'https://run065.example.com',
corporateRegistrationNumber: 'corporate_registration_number',
customerReference: 'internal-id-12345',
dunBradstreetNumber: 'dun_bradstreet_number',
primaryBusinessDomainSicCode: 'primary_business_domain_sic_code',
professionalLicenseNumber: 'professional_license_number',
roleType: 'enterprise',
);
var_dump($enterprise);
} catch (APIException $e) {
echo $e->getMessage();
}telnyx enterprises create \
--api-key 'My API Key' \
--billing-address "{administrative_area: IL, city: Chicago, country: US, postal_code: '60601', street_address: 100 Main St}" \
--billing-contact "{email: [email protected], first_name: Alex, last_name: Bill, 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 "{email: [email protected], 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, postal_code: '60601', street_address: 100 Main St}" \
--organization-type commercial \
--website https://run065.example.comcurl --request POST \
--url https://api.telnyx.com/v2/enterprises \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"legal_name": "Run 065 Debug Co",
"organization_type": "commercial",
"country_code": "US",
"role_type": "enterprise",
"website": "https://run065.example.com",
"fein": "12-3456789",
"industry": "technology",
"number_of_employees": "51-200",
"organization_legal_type": "llc",
"doing_business_as": "Run 065 Debug",
"jurisdiction_of_incorporation": "Delaware",
"organization_contact": {
"first_name": "Sam",
"last_name": "Org",
"email": "[email protected]",
"job_title": "Compliance Lead",
"phone_number": "+13125550000"
},
"billing_contact": {
"first_name": "Alex",
"last_name": "Bill",
"email": "[email protected]",
"phone_number": "+13125550001"
},
"organization_physical_address": {
"country": "US",
"administrative_area": "IL",
"city": "Chicago",
"postal_code": "60601",
"street_address": "100 Main St"
},
"billing_address": {
"country": "US",
"administrative_area": "IL",
"city": "Chicago",
"postal_code": "60601",
"street_address": "100 Main St"
}
}
'{
"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": "[email protected]",
"job_title": "Compliance Lead",
"phone_number": "+13125550000"
},
"billing_contact": {
"first_name": "Alex",
"last_name": "Bill",
"email": "[email protected]",
"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,
"bpo_verification_status": "approved",
"bpo_verification_rejection_reason": "Business registration document could not be verified."
}
}Authorizations
Telnyx API key. Generate one at https://portal.telnyx.com/#/app/api-keys.
Body
application/json
Your business's full registered legal name, exactly as it appears on your incorporation or tax documents, 3 to 64 characters.
Required string length:
3 - 64Example:
"Acme Plumbing LLC"
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"
ISO 3166-1 alpha-2 country code. Currently US and CA are supported.
Example:
"US"
Your business's public website address, including https://. Leave blank if your business has no website.
Maximum string length:
255Example:
"https://acmeplumbing.example.com"
US Federal Employer Identification Number (NN-NNNNNNN) or Canadian equivalent.
Example:
"12-3456789"
The industry your business operates in. Choose the closest match from the list; if your value is not accepted, pick the nearest category.
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"
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"
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"
The trade name your business operates under if it is different from your legal name, also called a Doing Business As (DBA) name. Leave blank if you only use your legal name.
Maximum string length:
255Example:
"Acme Plumbing"
The state, province, or country where your business was legally incorporated, for example Delaware.
Maximum string length:
255Example:
"Delaware"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
enterprise for an organization registering its own DIRs (the default, and the right choice when the calls display your own brand). bpo for a Business Process Outsourcer: a call center that places calls on behalf of other enterprises and displays their brand. A bpo enterprise describes the call center itself and cannot own a DIR. Each client the call center calls for gets its own enterprise in the same account, with the client's DIR under it; that DIR is then linked to the bpo enterprise through bpo_authorizations. Fixed at creation.
Available options:
enterprise, bpo Example:
"enterprise"
Your own label for this account. Enter any reference that helps you find it in your records. Telnyx does not use it during vetting.
Maximum string length:
255Example:
"internal-id-12345"
The 4-digit Standard Industrial Classification code for your main line of business, which tells us what industry you operate in. Look it up in the SIC code directory if you are unsure.
The official number your company received when it was legally registered or incorporated (for example from your state or national business registry). It is on your certificate of incorporation.
If your business operates under a professional license (for example legal, medical, or financial services), enter the license number issued by the licensing authority. Leave blank if it does not apply.
Your optional 9-digit D-U-N-S Number issued by Dun & Bradstreet, a unique identifier for your business. Leave blank if you do not have one.
Response
Enterprise created.
Show child attributes
Show child attributes
Was this page helpful?
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: '[email protected]',
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: '[email protected]',
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);import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
enterprise = 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": "[email protected]",
"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": "[email protected]",
"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",
)
print(enterprise.data)
package main
import (
"context"
"fmt"
"github.com/team-telnyx/telnyx-go"
"github.com/team-telnyx/telnyx-go/option"
)
func main() {
client := telnyx.NewClient(
option.WithAPIKey("My API Key"),
)
enterprise, err := client.Enterprises.New(context.TODO(), telnyx.EnterpriseNewParams{
BillingAddress: telnyx.BillingAddressParam{
Country: "US",
AdministrativeArea: "IL",
City: "Chicago",
PostalCode: "60601",
StreetAddress: "100 Main St",
},
BillingContact: telnyx.BillingContactParam{
FirstName: "Alex",
LastName: "Bill",
Email: "[email protected]",
PhoneNumber: "+13125550001",
},
CountryCode: "US",
DoingBusinessAs: "Run 065 Debug",
Fein: "12-3456789",
Industry: telnyx.EnterpriseNewParamsIndustryTechnology,
JurisdictionOfIncorporation: "Delaware",
LegalName: "Run 065 Debug Co",
NumberOfEmployees: telnyx.EnterpriseNewParamsNumberOfEmployeesNumberOfEmployees51_200,
OrganizationContact: telnyx.OrganizationContactParam{
FirstName: "Sam",
LastName: "Org",
Email: "[email protected]",
JobTitle: "Compliance Lead",
PhoneNumber: "+13125550000",
},
OrganizationLegalType: telnyx.EnterpriseNewParamsOrganizationLegalTypeLlc,
OrganizationPhysicalAddress: telnyx.PhysicalAddressParam{
Country: "US",
AdministrativeArea: "IL",
City: "Chicago",
PostalCode: "60601",
StreetAddress: "100 Main St",
},
OrganizationType: telnyx.EnterpriseNewParamsOrganizationTypeCommercial,
Website: "https://run065.example.com",
RoleType: telnyx.EnterpriseNewParamsRoleTypeEnterprise,
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", enterprise.Data)
}
package com.telnyx.sdk.example;
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.enterprises.BillingAddress;
import com.telnyx.sdk.models.enterprises.BillingContact;
import com.telnyx.sdk.models.enterprises.EnterpriseCreateParams;
import com.telnyx.sdk.models.enterprises.EnterpriseCreateResponse;
import com.telnyx.sdk.models.enterprises.OrganizationContact;
import com.telnyx.sdk.models.enterprises.PhysicalAddress;
public final class Main {
private Main() {}
public static void main(String[] args) {
TelnyxClient client = TelnyxOkHttpClient.fromEnv();
EnterpriseCreateParams params = EnterpriseCreateParams.builder()
.billingAddress(BillingAddress.builder()
.administrativeArea("IL")
.city("Chicago")
.country("US")
.postalCode("60601")
.streetAddress("100 Main St")
.build())
.billingContact(BillingContact.builder()
.email("[email protected]")
.firstName("Alex")
.lastName("Bill")
.phoneNumber("+13125550001")
.build())
.countryCode("US")
.doingBusinessAs("Run 065 Debug")
.fein("12-3456789")
.industry(EnterpriseCreateParams.Industry.TECHNOLOGY)
.jurisdictionOfIncorporation("Delaware")
.legalName("Run 065 Debug Co")
.numberOfEmployees(EnterpriseCreateParams.NumberOfEmployees.NUMBER_OF_EMPLOYEES_51_200)
.organizationContact(OrganizationContact.builder()
.email("[email protected]")
.firstName("Sam")
.jobTitle("Compliance Lead")
.lastName("Org")
.phoneNumber("+13125550000")
.build())
.organizationLegalType(EnterpriseCreateParams.OrganizationLegalType.LLC)
.organizationPhysicalAddress(PhysicalAddress.builder()
.administrativeArea("IL")
.city("Chicago")
.country("US")
.postalCode("60601")
.streetAddress("100 Main St")
.build())
.organizationType(EnterpriseCreateParams.OrganizationType.COMMERCIAL)
.website("https://run065.example.com")
.build();
EnterpriseCreateResponse enterprise = client.enterprises().create(params);
}
}require "telnyx"
telnyx = Telnyx::Client.new(api_key: "My API Key")
enterprise = telnyx.enterprises.create(
billing_address: {administrative_area: "IL", city: "Chicago", country: "US", postal_code: "60601", street_address: "100 Main St"},
billing_contact: {email: "[email protected]", first_name: "Alex", last_name: "Bill", 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: {
email: "[email protected]",
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", postal_code: "60601", street_address: "100 Main St"},
organization_type: :commercial,
website: "https://run065.example.com"
)
puts(enterprise)<?php
require_once dirname(__DIR__) . '/vendor/autoload.php';
use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;
$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');
try {
$enterprise = $client->enterprises->create(
billingAddress: [
'administrativeArea' => 'IL',
'city' => 'Chicago',
'country' => 'US',
'postalCode' => '60601',
'streetAddress' => '100 Main St',
'extendedAddress' => 'Suite 504',
],
billingContact: [
'email' => '[email protected]',
'firstName' => 'Alex',
'lastName' => 'Bill',
'phoneNumber' => '+13125550001',
],
countryCode: 'US',
doingBusinessAs: 'Run 065 Debug',
fein: '12-3456789',
industry: 'technology',
jurisdictionOfIncorporation: 'Delaware',
legalName: 'Run 065 Debug Co',
numberOfEmployees: '51-200',
organizationContact: [
'email' => '[email protected]',
'firstName' => 'Sam',
'jobTitle' => 'Compliance Lead',
'lastName' => 'Org',
'phoneNumber' => '+13125550000',
],
organizationLegalType: 'llc',
organizationPhysicalAddress: [
'administrativeArea' => 'IL',
'city' => 'Chicago',
'country' => 'US',
'postalCode' => '60601',
'streetAddress' => '100 Main St',
'extendedAddress' => 'Suite 504',
],
organizationType: 'commercial',
website: 'https://run065.example.com',
corporateRegistrationNumber: 'corporate_registration_number',
customerReference: 'internal-id-12345',
dunBradstreetNumber: 'dun_bradstreet_number',
primaryBusinessDomainSicCode: 'primary_business_domain_sic_code',
professionalLicenseNumber: 'professional_license_number',
roleType: 'enterprise',
);
var_dump($enterprise);
} catch (APIException $e) {
echo $e->getMessage();
}telnyx enterprises create \
--api-key 'My API Key' \
--billing-address "{administrative_area: IL, city: Chicago, country: US, postal_code: '60601', street_address: 100 Main St}" \
--billing-contact "{email: [email protected], first_name: Alex, last_name: Bill, 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 "{email: [email protected], 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, postal_code: '60601', street_address: 100 Main St}" \
--organization-type commercial \
--website https://run065.example.comcurl --request POST \
--url https://api.telnyx.com/v2/enterprises \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"legal_name": "Run 065 Debug Co",
"organization_type": "commercial",
"country_code": "US",
"role_type": "enterprise",
"website": "https://run065.example.com",
"fein": "12-3456789",
"industry": "technology",
"number_of_employees": "51-200",
"organization_legal_type": "llc",
"doing_business_as": "Run 065 Debug",
"jurisdiction_of_incorporation": "Delaware",
"organization_contact": {
"first_name": "Sam",
"last_name": "Org",
"email": "[email protected]",
"job_title": "Compliance Lead",
"phone_number": "+13125550000"
},
"billing_contact": {
"first_name": "Alex",
"last_name": "Bill",
"email": "[email protected]",
"phone_number": "+13125550001"
},
"organization_physical_address": {
"country": "US",
"administrative_area": "IL",
"city": "Chicago",
"postal_code": "60601",
"street_address": "100 Main St"
},
"billing_address": {
"country": "US",
"administrative_area": "IL",
"city": "Chicago",
"postal_code": "60601",
"street_address": "100 Main St"
}
}
'{
"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": "[email protected]",
"job_title": "Compliance Lead",
"phone_number": "+13125550000"
},
"billing_contact": {
"first_name": "Alex",
"last_name": "Bill",
"email": "[email protected]",
"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,
"bpo_verification_status": "approved",
"bpo_verification_rejection_reason": "Business registration document could not be verified."
}
}