Skip to main content

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.

​
Overview

An Enterprise represents your business entity on the Telnyx platform. It’s the top-level resource required before you can use Number Reputation or Branded Calling features. Register your organization once, then opt into either or both products:
  • Number Reputation — monitor and manage spam reputation of your outbound calling numbers
  • Branded Calling — display your business name, logo, and call reason on recipients’ screens (coming soon)

​
What you need

To create an enterprise, you’ll need:
FieldDescription
legal_nameRegistered legal name (3–64 characters)
doing_business_asDBA name
organization_typecommercial, government, or non_profit
country_codeISO 3166-1 alpha-2 (e.g. US)
websiteYour business website
feinFederal Employer Identification Number (EIN)
industryIndustry classification
organization_physical_addressPhysical business address
billing_contactBilling contact information
billing_addressBilling address

​
Quick start

​
1. Accept Terms of Service

Before creating an enterprise, accept the Number Reputation Terms of Service: 
curl -X POST https://api.telnyx.com/v2/terms_of_service/number_reputation/agree \
  -H "Authorization: Bearer YOUR_API_KEY"

​
2. Create an enterprise

curl -X POST https://api.telnyx.com/v2/enterprises \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "legal_name": "Acme Corp",
    "doing_business_as": "Acme",
    "organization_type": "commercial",
    "country_code": "US",
    "website": "https://acme.com",
    "fein": "12-3456789",
    "industry": "technology",
    "number_of_employees": "51-200",
    "organization_legal_type": "corporation",
    "organization_contact": {
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@acme.com",
      "job_title": "CTO",
      "phone": "+12025551234"
    },
    "billing_contact": {
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "billing@acme.com",
      "phone_number": "+12025551234"
    },
    "organization_physical_address": {
      "country": "US",
      "administrative_area": "CA",
      "city": "San Francisco",
      "postal_code": "94105",
      "street_address": "123 Main St"
    },
    "billing_address": {
      "country": "US",
      "administrative_area": "CA",
      "city": "San Francisco",
      "postal_code": "94105",
      "street_address": "123 Main St"
    }
  }'
The response includes an id — use this enterprise ID for all subsequent API calls.

​
3. Next steps

​
Enterprise and product relationship

The enterprise is a shared resource — register once and use it across both Number Reputation and Branded Calling. Fields like doing_business_as and industry are specifically required by the Number Reputation provider, while fields like billing_address are needed for Branded Calling. The API collects everything upfront so you don’t need to update later.

​
Access requirements

All Branded Calling and Number Reputation endpoints require a verified or enterprise-level Telnyx account. Trial and standard paid accounts cannot access these features. See Account Levels and Capabilities for details on upgrading.