Skip to main content
PUT
/
enterprises
/
{enterprise_id}
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.update('4a6192a4-573d-446d-b3ce-aff9117272a6', {
  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@acmeplumbing.example.com',
    phone_number: '+13125550001',
  },
  customer_reference: 'internal-ref-2026Q2',
  doing_business_as: 'Acme Plumbing',
  fein: '12-3456789',
  industry: 'business',
  jurisdiction_of_incorporation: 'Delaware',
  legal_name: 'Acme Plumbing LLC',
  number_of_employees: '51-200',
  organization_contact: {
    first_name: 'Sam',
    last_name: 'Owner',
    email: 'sam@acmeplumbing.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',
  },
  website: 'https://acmeplumbing.example.com',
});

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.

Path Parameters

​
enterprise_id
string<uuid>
required

The enterprise id. Lowercase UUID.

Example:

"4a6192a4-573d-446d-b3ce-aff9117272a6"

Body

application/json

All fields are optional; only the ones supplied are updated. The same field-level rules from EnterpriseCreateRequest apply.

​
legal_name
string

Legal name of the enterprise.

Required string length: 3 - 64
​
website
string<uri>
Maximum string length: 255
​
fein
string
​
industry
enum<string>
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
​
number_of_employees
string
​
organization_legal_type
string
​
doing_business_as
string
Maximum string length: 255
​
customer_reference
string
Maximum string length: 255
​
primary_business_domain_sic_code
string | null
​
corporate_registration_number
string | null
​
professional_license_number
string | null
​
dun_bradstreet_number
string | null
​
organization_contact
object
​
billing_contact
object
​
organization_physical_address
object
​
billing_address
object
​
jurisdiction_of_incorporation
string

Updated state/province/country of incorporation. Optional on update.

Maximum string length: 255
Example:

"Delaware"

Response

Enterprise updated.

​
data
object
required