Access Tokens1

Actions2

Addresses6

Advanced Number Orders4

AI Collections14

AI Gateway14

AI Tests34

Anthropic Messages1

Artifacts2

Assistants50

Audio1

Audit Logs1

Authentication Providers5

AutoRechargePreferences2

Avatars4

Billing1

Billing Groups5

Bot Signup4

Brands16

Browser Sessions4

Bucket SSL Certificate3

Bucket Usage2

Bulk Phone Number Campaigns3

Bulk Phone Number Operations5

Bundles2

Call Commands42

Call Control Applications5

Call Information3

Call Recordings11

Campaign15

CDR Reports10

CDR Usage Reports9

Chat4

cloudfs filesystems6

Clusters5

Comments2

Conference Commands23

Connections3

Contents1

Conversation Histories1

Conversations21

Country Coverage2

Coverage1

Credential Connections6

Credentials5

CSV Downloads3

Customer Service Record4

Data Migration9

Debugging1

Decision Models1

Dedicated IPs9

Detail Records1

Dialogflow Integration4

DIR References3

Display Identity Records10

Documents8

Dynamic Emergency Addresses4

Dynamic Emergency Endpoints4

Email Domain DNS Records2

Email Domains7

Email Drafts8

Email Events2

Email Inboxes19

Email Messages11

Email Suppression Imports2

Email Suppressions6

Email Templates7

Email Threads2

Email Unsubscribe Groups8

Email Validations3

Email Verification5

Email Webhooks5

Embeddings8

Enterprises6

Enum1

External Connections23

Fine Tuning4

FQDN Connections7

FQDNs5

functions8

Global IPs21

Hosted Numbers9

Inexplicit Number Orders3

Infringement Claims4

Integration Secrets3

Integrations5

Inventory Level1

IP Addresses4

IP Connections5

IP Pools7

IP Ranges3

IPs5

kv keys4

kv namespaces4

Machine Payments1

Managed Accounts8

MCP Servers5

MDR Detail Reports1

MDR Detailed Reports8

MDR Usage Reports13

Media Storage API6

Meeting Session Actions3

Meeting Session Artifacts3

Meeting Session Data3

Meeting Sessions5

Memory5

Messages11

Messaging15

Messaging URL Domains1

Missions41

Mobile Network Operators1

Mobile Number Settings2

Mobile Phone Numbers3

Mobile Voice Connections5

Namespaces3

Network Routes4

Networks9

Noise Suppression Engines1

Notifications16

Number Lookup1

Number Portout14

Number Settings7

numbers features1

OAuth Clients10

OAuth Discovery2

OAuth Grants6

OAuth Protocol7

OpenAI Chat3

OpenAI Embeddings2

Operations1

Opt-Out Management6

Organization Users4

OTA updates2

Outbound Voice Profiles5

Pay Connectors5

Phone Number Batches2

Phone Number Block Orders3

Phone Number Blocks Background Jobs3

Phone Number Campaigns5

Phone Number Configurations11

Phone Number Orders21

Phone Number Porting1

Phone Number Reservations4

Phone Number Search2

Phone Numbers3

Porting Orders53

Presigned Object URLs1

Pricing2

Private Wireless Gateways4

Profiles11

Programmable Fax Applications5

Programmable Fax Commands6

Pronunciation Dictionaries5

Public Internet Gateways4

Push Credentials4

Queue Commands9

RCS9

RCS Agents10

RCS Brands5

Reference Data3

Regions1

Regulatory Requirements3

Reporting8

Reports2

Reputation22

Requirement Groups10

Requirement Types2

Requirements4

Research2

Room Compositions4

Room Participants2

Room Recordings4

Room Sessions7

Rooms6

Rooms Client Tokens2

Session Analysis3

SETI Observability1

Settings2

Shared Campaigns5

Short Codes3

SIM Card Actions4

SIM Card Group Actions2

SIM Card Groups9

SIM Card Orders4

SIM Cards26

SIPREC Connectors4

Sources3

Speech to Text Batch Reports8

Speech To Text Capabilities1

Speech To Text over WebSockets1

Speech to text Usage Reports2

Spend Limits4

sql databases5

stateful actors1

Stored Payment Transactions1

Tailscale Subnet Routers5

Telco Data Usage Reports8

Terms of Service6

TeXML Applications5

TeXML REST Commands35

Text To Speech Commands3

Traffic Policy Profiles12

Tunnels5

UAC Connections7

Usage Reports (BETA)2

User Bundles6

User Tags1

UserAddresses6

Verification Requests7

Verified Numbers5

Verify16

Virtual Cross Connects7

Voice Channels6

Voice Clones6

Voice Designs7

Voice SDK Stats2

Voicemail3

WDR Detail Reports1

Web Search1

Webhooks2

Whatsapp Business Accounts14

Whatsapp Message Templates10

Whatsapp messaging1

Whatsapp Phone Numbers34

Whatsapp Signup5

WireGuard Interfaces10

Wireless Blocklists6

Wireless Regions1

x402 Payment Transactions4

Webhooks

Callbacks97

Meeting Session Webhooks4

Phone Numbers3

Enterprises

Replace an enterprise

Changed on Oct 15, 2026

Replace the enterprise's mutable fields. Only mutable fields may be sent. Server-assigned and immutable fields (id, record_type, created_at, updated_at, status fields, organization_type, country_code, role_type) cannot be changed: including any of them in the body is rejected with 400 Bad Request (Field 'X' is not allowed in this request).

For an approved BPO enterprise (role_type bpo), changing any identity field (legal name, DBA, website, FEIN, industry, number of employees, physical address, organization contact, D-U-N-S number, legal type, SIC code, corporate registration number, professional license number, or jurisdiction of incorporation) resets bpo_verification_status to pending for re-approval and sets every DIR authorization for that BPO to rejected. After re-approval, link it again with a newly signed LOA (a new loa_document_id); resending the old one keeps the authorization rejected. Re-sending an unchanged value does not reset anything.

If Number Reputation is enabled on the enterprise, legal_name, doing_business_as, website, fein, industry, number_of_employees, organization_physical_address, organization_contact, and dun_bradstreet_number cannot be changed: the request is rejected with 400.

put/enterprises/{enterprise_id}

Request

Base URL
https://api.telnyx.com/v2
URL
https://api.telnyx.com/v2/enterprises/{enterprise_id}
Auth
HTTP bearer

Path parameters

enterprise_idstring uuid required

Example:4a6192a4-573d-446d-b3ce-aff9117272a6

The enterprise id. Lowercase UUID.

Request body

legal_namestring

Your business's full registered legal name, exactly as it appears on your incorporation or tax documents, 3 to 64 characters.

websitestring uri

Your business's public website address, including https://. Leave blank if your business has no website.

feinstring

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

The industry your business operates in. Choose the closest match from the list; if your value is not accepted, pick the nearest category.

number_of_employeesstring

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

organization_legal_typestring

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.

doing_business_asstring

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.

customer_referencestring

Your own label for this account. Enter any reference that helps you find it in your records. Telnyx does not use it during vetting.

primary_business_domain_sic_codestring nullable

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.

corporate_registration_numberstring nullable

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.

professional_license_numberstring nullable

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.

dun_bradstreet_numberstring nullable

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.

jurisdiction_of_incorporationstring

The state, province, or country where your business was legally incorporated, for example Delaware.

Example request

{
  "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"
  },
  "jurisdiction_of_incorporation": "Delaware"
}

Response

Enterprise updated.

Example response

{
  "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",
    "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",
    "bpo_verification_status": "approved",
    "bpo_verification_rejection_reason": "Business registration document could not be verified."
  }
}

Changes

Oct 15, 2026a72569d69430 Revision changes
- warning
  added the new bpo enum value to the / response property for the response status
- warning
  added the new enterprise enum value to the / response property for the response status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
Jun 5, 20268a8c40f458c5 Revision changes
- breaking
  added the new required request property /
- breaking
  request property was restricted to a list of enum values
- breaking
  removed the enum value 1-10 of the request property
- breaking
  removed the enum value 10001+ of the request property
- breaking
  removed the enum value 11-50 of the request property
- breaking
  removed the enum value 2001-10000 of the request property
- breaking
  removed the enum value 201-500 of the request property
- breaking
  removed the enum value 501-2000 of the request property
- breaking
  removed the enum value 51-200 of the request property
- breaking
  removed the enum value corporation of the request property
- breaking
  removed the enum value llc of the request property
- breaking
  removed the enum value nonprofit of the request property
- breaking
  removed the enum value other of the request property
- breaking
  removed the enum value partnership of the request property
- breaking
  the request property type changed from object to no type
- breaking
  the request property format changed from no format to uri
- breaking
  the // response property's maxLength was unset from 255 for the response status
- breaking
  the // response property's maxLength was unset from 20 for the response status
- breaking
  the // response property's maxLength was unset from 255 for the response status
- breaking
  the // response property's maxLength was unset from 100 for the response status
- breaking
  the // response property's maxLength was unset from 100 for the response status
- breaking
  the / response's property type changed from object to no type for status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the optional property // from the response with the status
- info
  api operation id UpdateEnterprise removed and replaced with updateEnterprise
- info
  added the new optional request property
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property became nullable
- info
  added the new accounting enum value to the request property
- info
  added the new banking enum value to the request property
- info
  added the new billing enum value to the request property
- info
  added the new business enum value to the request property
- info
  added the new charity enum value to the request property
- info
  added the new collections enum value to the request property
- info
  added the new communications enum value to the request property
- info
  added the new customer service enum value to the request property
- info
  added the new delivery enum value to the request property
- info
  added the new ecommerce enum value to the request property
- info
  added the new education enum value to the request property
- info
  added the new finance enum value to the request property
- info
  added the new financial enum value to the request property
- info
  added the new government enum value to the request property
- info
  added the new health enum value to the request property
- info
  added the new healthcare enum value to the request property
- info
  added the new hospitality enum value to the request property
- info
  added the new hotel enum value to the request property
- info
  added the new insurance enum value to the request property
- info
  added the new law enum value to the request property
- info
  added the new legal enum value to the request property
- info
  added the new logistics enum value to the request property
- info
  added the new market research enum value to the request property
- info
  added the new marketing enum value to the request property
- info
  added the new media enum value to the request property
- info
  added the new medical enum value to the request property
- info
  added the new nonprofit enum value to the request property
- info
  added the new notifications enum value to the request property
- info
  added the new pharmacy enum value to the request property
- info
  added the new property enum value to the request property
- info
  added the new public enum value to the request property
- info
  added the new real estate enum value to the request property
- info
  added the new retail enum value to the request property
- info
  added the new sales enum value to the request property
- info
  added the new scheduling enum value to the request property
- info
  added the new shipping enum value to the request property
- info
  added the new software enum value to the request property
- info
  added the new support enum value to the request property
- info
  added the new surveys enum value to the request property
- info
  added the new tech enum value to the request property
- info
  added the new technology enum value to the request property
- info
  added the new telecom enum value to the request property
- info
  added the new travel enum value to the request property
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  the response optional property / became read-only for the status
- info
  the response optional property / became read-only for the status
- info
  the response optional property / became read-only for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property /// became required for the status
- info
  the response property /// became required for the status
- info
  the response property /// became required for the status
- info
  removed the 1-10 enum value from the / response property for the response status
- info
  removed the 10001+ enum value from the / response property for the response status
- info
  removed the 11-50 enum value from the / response property for the response status
- info
  removed the 2001-10000 enum value from the / response property for the response status
- info
  removed the 201-500 enum value from the / response property for the response status
- info
  removed the 501-2000 enum value from the / response property for the response status
- info
  removed the 51-200 enum value from the / response property for the response status
- info
  removed the bpo enum value from the / response property for the response status
- info
  removed the commercial enum value from the / response property for the response status
- info
  removed the corporation enum value from the / response property for the response status
- info
  removed the enterprise enum value from the / response property for the response status
- info
  removed the government enum value from the / response property for the response status
- info
  removed the llc enum value from the / response property for the response status
- info
  removed the non_profit enum value from the / response property for the response status
- info
  removed the nonprofit enum value from the / response property for the response status
- info
  removed the other enum value from the / response property for the response status
- info
  removed the partnership enum value from the / response property for the response status
- info
  added the required property // to the response with the status

Operation history