Enterprises

Create an enterprise

Changed on

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 response errors[].source.pointer names the field).
  • 409 - an enterprise with the same identifying details already exists under your account.
post/enterprises

Request

  • Base URL
    https://api.telnyx.com/v2
  • URL
    https://api.telnyx.com/v2/enterprises
  • Auth
    HTTP bearer

Request body

legal_namestring required

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

organization_type'commercial' | 'government' | 'non_profit' required

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).
country_codestring required

ISO 3166-1 alpha-2 country code. Currently US and CA are supported.

role_type'enterprise' | 'bpo'

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.

websitestring uri required

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

feinstring required

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

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_employees'1-10' | '11-50' | '51-200' | '201-500' | '501-2000' | '2001-10000' | '10001+' required

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

organization_legal_type'corporation' | 'llc' | 'partnership' | 'nonprofit' | 'other' required

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 required

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.

jurisdiction_of_incorporationstring required

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

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.

Example request

{
  "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"
  }
}

Response

Enterprise created.

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

  • a72569d69430Revision 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

  • 8a8c40f458c5Revision changes
    • breaking

      added the new required request property

    • breaking

      added the new required request property /

    • breaking

      request property was restricted to a list of enum values

    • 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 CreateEnterprise removed and replaced with createEnterprise

    • 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

      the request property's minLength was decreased from 2 to 0

    • 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