For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
AcademyContact SalesHelp CenterDashboard
DocumentationAPI ReferenceIntegrationsAdministrationChangelog
DocumentationAPI ReferenceIntegrationsAdministrationChangelog
  • Get Started
    • Introduction
    • Aurora
  • Build
    • Create an Agent
    • The Agent Editor
    • Single-Prompt Agents
    • Memory
    • Knowledge Base
    • Variables
    • Version Control
  • Evaluate
    • Manual Testing
    • Custom Evaluations
    • Simulations
  • Launch
    • Deployment Options
      • Overview
        • Buy a Phone Number
        • Import Phone Numbers
      • Connect your Phone System
      • SIP Trunking Network ACL
      • Egress IP Addresses
      • Performance Metrics
      • Concurrency
      • Telephony Errors
      • Forward Calls to Synthflow
      • Call Transfer to SIP
      • Deploy in LATAM Regions
    • WhatsApp
    • Website and Apps
    • Launching a Chat Agent
    • Workflows
  • Learn
    • Analytics Dashboard
    • Logs
    • Export Call Data
  • Legal
    • Subscriber Terms
    • GTC - Direct Use (DACH)
    • GTC - Direct Use (US)
    • GTC - Distribution (DACH)
    • GTC - Distribution (US)
    • Business Associate Agreement
    • Privacy Policy
    • Imprint
    • AI Transparency Statement
    • Trust Vault
LogoLogo
AcademyContact SalesHelp CenterDashboard
On this page
  • What is a Custom Number?
  • Supported Integrations
  • Adding Custom Numbers
  • FAQs
  • Need Help?
LaunchTelephonyPhone Numbers

Custom Phone Numbers

Add and manage your own phone numbers via SIP trunks or PBX systems.
||View as Markdown|
Was this page helpful?
Previous

Connect your phone system (SIP/PBX)

Next
Built with

Modal showing the import custom number setup

Bring your own numbers (BYON) to Synthflow and connect your carrier, trunk, or PBX directly to our network. This guide explains the options, requirements, and steps for adding custom numbers.

What is a Custom Number?

A Custom Number lets Enterprise and Agency customers connect their own phone numbers through SIP trunks or PBX systems.

With this setup, Synthflow AI Agents act as an extension of your trunk/PBX—giving you more control over call routing and number management.

Learn more about how this works on our SIP Integration page.

Supported Integrations

Synthflow integrates with a variety of carriers and vendors such as RingCentral, Telnyx, and Twilio.

  • See our integration guides for setup help.
  • We’re constantly adding new partners—ask your account manager if you don’t see your vendor listed.

Adding Custom Numbers

When adding a custom number in the Synthflow portal, you’ll be asked to configure several fields:

  • Phone Number – The CLI your AI Agent will use. Must be in E.164 format (+<countrycode><number>).

  • SIP Domain – The destination domain for outbound calls.

  • Username – Authentication username (if required by your carrier/trunk/PBX).

  • Password – Authentication password (if required).

  • Outbound Proxy – Use when:

    • sending requests via a mid-registrar/proxy
    • using a non-standard SIP port (e.g., 5065) Format: sip:fqdn/ip:port
    • using a specific transport (e.g., TCP) Format: sip:fqdn/ip;transport=tcp.

    When specified it will override SIP Domain as the destination for all outbound calls and registrations.

  • Auth Username – Used for REGISTER requests from Synthflow to your carrier/trunk/PBX (optional, depending on carrier).

  • Origination URI – The Synthflow SIP address and port we use to send traffic.

FAQs

How do I enable this?
  1. Go to your workspace.
  2. Click Phone Numbers in the top-right.
  3. Select New Phone Number → Import a Custom Number.

If you see an Upgrade button instead, this feature requires an Enterprise account. Please contact your account manager for details.

I just upgraded to Enterprise—when can I add numbers?

Immediately. If the option doesn’t appear, try logging out and back in. If it still doesn’t show, contact support.

Do you support non-standard SIP ports?

Yes. Use the Outbound Proxy field when adding a number to specify a custom port (e.g., fqdn.example.com:5065).

Need Help?

If you run into issues or have questions about supported carriers, contact your account manager or reach out to our support team.