> ## Documentation Index > Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt > Use this file to discover all available pages before exploring further. # Create an enterprise > Create a new enterprise for Branded Calling / Number Reputation services. Registers the enterprise in the Branded Calling / Number Reputation services, enabling it to create Display Identity Records (DIRs) or enroll in Number Reputation monitoring. **Required Fields:** `legal_name`, `doing_business_as`, `organization_type`, `country_code`, `website`, `fein`, `industry`, `number_of_employees`, `organization_legal_type`, `organization_contact`, `billing_contact`, `organization_physical_address`, `billing_address` ## OpenAPI ````yaml https://telnyx-openapi-ng.s3.us-east-1.amazonaws.com/number-reputation/enterprises.yml post /enterprises openapi: 3.1.0 info: title: Telnyx Number Reputation Enterprises API version: 2.0.0 description: >- Manage enterprises for Number Reputation. An enterprise represents your business entity and is the top-level resource for reputation monitoring. Register your organization once, then enable Number Reputation to start monitoring your phone numbers' spam reputation. contact: email: support@telnyx.com servers: - url: https://api.telnyx.com/v2 security: - bearerAuth: [] paths: /enterprises: post: tags: - Enterprises summary: Create an enterprise description: >- Create a new enterprise for Branded Calling / Number Reputation services. Registers the enterprise in the Branded Calling / Number Reputation services, enabling it to create Display Identity Records (DIRs) or enroll in Number Reputation monitoring. **Required Fields:** `legal_name`, `doing_business_as`, `organization_type`, `country_code`, `website`, `fein`, `industry`, `number_of_employees`, `organization_legal_type`, `organization_contact`, `billing_contact`, `organization_physical_address`, `billing_address` operationId: CreateEnterprise requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/EnterpriseCreate' responses: '201': description: Enterprise created successfully content: application/json: schema: $ref: '#/components/schemas/EnterprisePublicWrapped' '400': $ref: '#/components/responses/BadRequest' description: >- Bad request — invalid input, validation error, or duplicate legal_name '401': $ref: '#/components/responses/Unauthorized' '422': $ref: '#/components/responses/UnprocessableEntity' x-codeSamples: - lang: JavaScript source: |- 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: { administrative_area: 'Illinois', city: 'Chicago', country: 'United States', postal_code: '60601', street_address: '123 Main St', }, billing_contact: { email: 'billing@acme.com', first_name: 'John', last_name: 'Doe', phone_number: '15551234568', }, country_code: 'US', doing_business_as: 'Acme', fein: '12-3456789', industry: 'technology', legal_name: 'Acme Corp Inc.', number_of_employees: '51-200', organization_contact: { email: 'jane.smith@acme.com', first_name: 'Jane', job_title: 'VP of Engineering', last_name: 'Smith', phone: '+16035551234', }, organization_legal_type: 'corporation', organization_physical_address: { administrative_area: 'Illinois', city: 'Chicago', country: 'United States', postal_code: '60601', street_address: '123 Main St', }, organization_type: 'commercial', website: 'https://acme.com', }); console.log(enterprise.data); - lang: Python source: |- 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={ "administrative_area": "Illinois", "city": "Chicago", "country": "United States", "postal_code": "60601", "street_address": "123 Main St", }, billing_contact={ "email": "billing@acme.com", "first_name": "John", "last_name": "Doe", "phone_number": "15551234568", }, country_code="US", doing_business_as="Acme", fein="12-3456789", industry="technology", legal_name="Acme Corp Inc.", number_of_employees="51-200", organization_contact={ "email": "jane.smith@acme.com", "first_name": "Jane", "job_title": "VP of Engineering", "last_name": "Smith", "phone": "+16035551234", }, organization_legal_type="corporation", organization_physical_address={ "administrative_area": "Illinois", "city": "Chicago", "country": "United States", "postal_code": "60601", "street_address": "123 Main St", }, organization_type="commercial", website="https://acme.com", ) print(enterprise.data) - lang: Go source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/team-telnyx/telnyx-go\"\n\t\"github.com/team-telnyx/telnyx-go/option\"\n)\n\nfunc main() {\n\tclient := telnyx.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tenterprise, err := client.Enterprises.New(context.TODO(), telnyx.EnterpriseNewParams{\n\t\tBillingAddress: telnyx.BillingAddressParam{\n\t\t\tAdministrativeArea: \"Illinois\",\n\t\t\tCity: \"Chicago\",\n\t\t\tCountry: \"United States\",\n\t\t\tPostalCode: \"60601\",\n\t\t\tStreetAddress: \"123 Main St\",\n\t\t},\n\t\tBillingContact: telnyx.BillingContactParam{\n\t\t\tEmail: \"billing@acme.com\",\n\t\t\tFirstName: \"John\",\n\t\t\tLastName: \"Doe\",\n\t\t\tPhoneNumber: \"15551234568\",\n\t\t},\n\t\tCountryCode: \"US\",\n\t\tDoingBusinessAs: \"Acme\",\n\t\tFein: \"12-3456789\",\n\t\tIndustry: \"technology\",\n\t\tLegalName: \"Acme Corp Inc.\",\n\t\tNumberOfEmployees: telnyx.EnterpriseNewParamsNumberOfEmployeesNumberOfEmployees51_200,\n\t\tOrganizationContact: telnyx.OrganizationContactParam{\n\t\t\tEmail: \"jane.smith@acme.com\",\n\t\t\tFirstName: \"Jane\",\n\t\t\tJobTitle: \"VP of Engineering\",\n\t\t\tLastName: \"Smith\",\n\t\t\tPhone: \"+16035551234\",\n\t\t},\n\t\tOrganizationLegalType: telnyx.EnterpriseNewParamsOrganizationLegalTypeCorporation,\n\t\tOrganizationPhysicalAddress: telnyx.PhysicalAddressParam{\n\t\t\tAdministrativeArea: \"Illinois\",\n\t\t\tCity: \"Chicago\",\n\t\t\tCountry: \"United States\",\n\t\t\tPostalCode: \"60601\",\n\t\t\tStreetAddress: \"123 Main St\",\n\t\t},\n\t\tOrganizationType: telnyx.EnterpriseNewParamsOrganizationTypeCommercial,\n\t\tWebsite: \"https://acme.com\",\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", enterprise.Data)\n}\n" - lang: Java source: |- 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("Illinois") .city("Chicago") .country("United States") .postalCode("60601") .streetAddress("123 Main St") .build()) .billingContact(BillingContact.builder() .email("billing@acme.com") .firstName("John") .lastName("Doe") .phoneNumber("15551234568") .build()) .countryCode("US") .doingBusinessAs("Acme") .fein("12-3456789") .industry("technology") .legalName("Acme Corp Inc.") .numberOfEmployees(EnterpriseCreateParams.NumberOfEmployees.NUMBER_OF_EMPLOYEES_51_200) .organizationContact(OrganizationContact.builder() .email("jane.smith@acme.com") .firstName("Jane") .jobTitle("VP of Engineering") .lastName("Smith") .phone("+16035551234") .build()) .organizationLegalType(EnterpriseCreateParams.OrganizationLegalType.CORPORATION) .organizationPhysicalAddress(PhysicalAddress.builder() .administrativeArea("Illinois") .city("Chicago") .country("United States") .postalCode("60601") .streetAddress("123 Main St") .build()) .organizationType(EnterpriseCreateParams.OrganizationType.COMMERCIAL) .website("https://acme.com") .build(); EnterpriseCreateResponse enterprise = client.enterprises().create(params); } } - lang: Ruby source: |- require "telnyx" telnyx = Telnyx::Client.new(api_key: "My API Key") enterprise = telnyx.enterprises.create( billing_address: { administrative_area: "Illinois", city: "Chicago", country: "United States", postal_code: "60601", street_address: "123 Main St" }, billing_contact: {email: "billing@acme.com", first_name: "John", last_name: "Doe", phone_number: "15551234568"}, country_code: "US", doing_business_as: "Acme", fein: "12-3456789", industry: "technology", legal_name: "Acme Corp Inc.", number_of_employees: :"51-200", organization_contact: { email: "jane.smith@acme.com", first_name: "Jane", job_title: "VP of Engineering", last_name: "Smith", phone: "+16035551234" }, organization_legal_type: :corporation, organization_physical_address: { administrative_area: "Illinois", city: "Chicago", country: "United States", postal_code: "60601", street_address: "123 Main St" }, organization_type: :commercial, website: "https://acme.com" ) puts(enterprise) - lang: CLI source: |- telnyx enterprises create \ --api-key 'My API Key' \ --billing-address "{administrative_area: Illinois, city: Chicago, country: United States, postal_code: '60601', street_address: 123 Main St}" \ --billing-contact "{email: billing@acme.com, first_name: John, last_name: Doe, phone_number: '15551234568'}" \ --country-code US \ --doing-business-as Acme \ --fein 12-3456789 \ --industry technology \ --legal-name 'Acme Corp Inc.' \ --number-of-employees 51-200 \ --organization-contact "{email: jane.smith@acme.com, first_name: Jane, job_title: VP of Engineering, last_name: Smith, phone: '+16035551234'}" \ --organization-legal-type corporation \ --organization-physical-address "{administrative_area: Illinois, city: Chicago, country: United States, postal_code: '60601', street_address: 123 Main St}" \ --organization-type commercial \ --website https://acme.com components: schemas: EnterpriseCreate: type: object required: - legal_name - doing_business_as - organization_type - country_code - website - fein - industry - number_of_employees - organization_legal_type - organization_contact - billing_contact - organization_physical_address - billing_address properties: legal_name: type: string minLength: 3 maxLength: 64 description: Legal name of the enterprise example: Acme Corp Inc. doing_business_as: type: string maxLength: 255 description: Primary business name / DBA name example: Acme organization_type: type: string enum: - commercial - government - non_profit description: Type of organization example: commercial country_code: type: string minLength: 2 maxLength: 2 description: Country code. Currently only 'US' is accepted. example: US role_type: type: string enum: - enterprise - bpo default: enterprise description: Role type in Branded Calling / Number Reputation services website: type: string maxLength: 255 description: >- Enterprise website URL. Accepts any string — no URL format validation enforced. example: https://acme.com fein: type: string maxLength: 20 description: >- Federal Employer Identification Number. Format: XX-XXXXXXX or 9-digit number (minimum 9 digits). example: 12-3456789 industry: type: string description: >- Industry classification. Case-insensitive. Accepted values: 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 number_of_employees: type: string enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-2000 - 2001-10000 - 10001+ description: Employee count range example: 51-200 organization_legal_type: type: string enum: - corporation - llc - partnership - nonprofit - other description: Legal structure type example: corporation primary_business_domain_sic_code: type: string maxLength: 10 description: SIC Code (optional) example: '7372' corporate_registration_number: type: string maxLength: 100 description: Corporate registration number (optional) professional_license_number: type: string maxLength: 100 description: Professional license number (optional) dun_bradstreet_number: type: string maxLength: 20 description: D-U-N-S Number (optional) customer_reference: type: string maxLength: 255 description: Optional customer reference identifier for your own tracking organization_contact: $ref: '#/components/schemas/OrganizationContact' billing_contact: $ref: '#/components/schemas/BillingContact' organization_physical_address: $ref: '#/components/schemas/PhysicalAddress' billing_address: $ref: '#/components/schemas/BillingAddress' EnterprisePublicWrapped: type: object properties: data: $ref: '#/components/schemas/EnterprisePublic' OrganizationContact: type: object required: - first_name - last_name - email - job_title - phone properties: first_name: type: string maxLength: 255 description: Contact's first name example: Jane last_name: type: string maxLength: 255 description: Contact's last name example: Smith email: type: string format: email maxLength: 255 description: Contact's email address example: jane.smith@acme.com job_title: type: string maxLength: 255 description: Contact's job title (required) example: VP of Engineering phone: type: string maxLength: 20 description: Contact's phone number in E.164 format example: '+16035551234' description: >- Organization contact information. Note: the response returns this object with the phone field as 'phone' (not 'phone_number'). BillingContact: type: object required: - first_name - last_name - email - phone_number properties: first_name: type: string maxLength: 255 description: Contact's first name example: John last_name: type: string maxLength: 255 description: Contact's last name example: Doe email: type: string format: email maxLength: 255 description: Contact's email address example: billing@acme.com phone_number: type: string maxLength: 20 description: Contact's phone number (10-15 digits) example: '15551234568' PhysicalAddress: type: object required: - country - administrative_area - city - postal_code - street_address properties: country: type: string maxLength: 100 description: Country name (e.g., United States) example: United States administrative_area: type: string maxLength: 100 description: State or province example: Illinois city: type: string maxLength: 100 description: City name example: Chicago postal_code: type: string maxLength: 20 description: ZIP or postal code example: '60601' street_address: type: string maxLength: 255 description: Street address example: 123 Main St extended_address: type: string nullable: true maxLength: 255 description: Additional address line (suite, apt, etc.) example: Suite 400 BillingAddress: type: object required: - country - administrative_area - city - postal_code - street_address properties: country: type: string maxLength: 100 description: Country name (e.g., United States) example: United States administrative_area: type: string maxLength: 100 description: State or province example: Illinois city: type: string maxLength: 100 description: City name example: Chicago postal_code: type: string maxLength: 20 description: ZIP or postal code example: '60601' street_address: type: string maxLength: 255 description: Street address example: 123 Main St extended_address: type: string nullable: true maxLength: 255 description: Additional address line (suite, apt, etc.) example: Suite 400 EnterprisePublic: type: object properties: id: type: string format: uuid description: Unique identifier of the enterprise example: 6a09cdc3-8948-47f0-aa62-74ac943d6c58 legal_name: type: string description: Legal name of the enterprise example: Acme Corp Inc. doing_business_as: type: string description: DBA name example: Acme organization_type: type: string enum: - commercial - government - non_profit description: Type of organization country_code: type: string description: ISO 3166-1 alpha-2 country code example: US role_type: type: string enum: - enterprise - bpo description: Role type in Branded Calling / Number Reputation services customer_reference: type: string nullable: true description: Customer reference identifier website: type: string nullable: true description: Company website URL fein: type: string nullable: true description: Federal Employer Identification Number industry: type: string nullable: true description: Industry classification number_of_employees: type: string nullable: true enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-2000 - 2001-10000 - 10001+ description: Employee count range organization_legal_type: type: string nullable: true enum: - corporation - llc - partnership - nonprofit - other description: Legal structure type primary_business_domain_sic_code: type: string nullable: true description: SIC Code corporate_registration_number: type: string nullable: true description: Corporate registration number professional_license_number: type: string nullable: true description: Professional license number dun_bradstreet_number: type: string nullable: true description: D-U-N-S Number organization_contact: $ref: '#/components/schemas/OrganizationContact' billing_contact: $ref: '#/components/schemas/BillingContact' organization_physical_address: $ref: '#/components/schemas/PhysicalAddress' billing_address: $ref: '#/components/schemas/BillingAddress' created_at: type: string format: date-time description: When the enterprise was created updated_at: type: string format: date-time description: When the enterprise was last updated branded-calling_ErrorResponse: type: object properties: errors: type: array items: $ref: '#/components/schemas/TelnyxError' TelnyxError: type: object properties: code: type: string description: Telnyx error code example: '10015' title: type: string description: Short error title example: Bad Request detail: type: string description: Human-readable error detail example: User has already agreed to Terms of Service version v1.0.0 meta: type: object properties: url: type: string format: uri description: Link to error documentation source: type: object description: Reference to the field that caused the error properties: pointer: type: string description: JSON pointer (RFC6901) to the field that caused the error example: /body/organization_type required: - code - title responses: BadRequest: description: Bad request — invalid input or validation error content: application/json: schema: $ref: '#/components/schemas/branded-calling_ErrorResponse' Unauthorized: description: Unauthorized — missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/branded-calling_ErrorResponse' UnprocessableEntity: description: >- Unprocessable entity — request structure is valid but contains semantic errors content: application/json: schema: $ref: '#/components/schemas/branded-calling_ErrorResponse' securitySchemes: bearerAuth: scheme: bearer type: http ````