Enterprises

Replace an enterprise

Changed on

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.

industry'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'

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

  • 27a8076ac294Revision 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