Connect Telnyx (Programmable Voice): API credentials and connection

Connect your Telnyx account to Omnifox to make and receive calls. All you need is your API Key and the Connection ID of your voice connection.

Jun 26, 2026

Telnyx Programmable Voice lets you make and receive calls inside Omnifox using your own Telnyx account. To connect it you only need two values: your API Key and the Connection ID of your voice connection. This guide is for beginners.

Requirements

  • An active Telnyx account (Mission Control Portal).
  • At least one phone number purchased in Telnyx.
  • A Voice Connection of type Call Control set up in Telnyx.
  • Permission to manage channels in Omnifox.

Step 1: Get the API Key in Telnyx

  1. Sign in to your Telnyx Mission Control Portal.
  2. Go to API Keys (account menu).
  3. Create a new API Key (or copy an existing one). It starts with KEY....
  4. Store it safely: the full key is shown only once.

Step 2: Get the Connection ID

  1. In Telnyx open Voice -> Call Control / Connections.
  2. Open your voice connection (or create a Call Control one).
  3. Copy the Connection ID (a long number). This is what routes the calls.

Step 3: Connect the channel in Omnifox

  1. In Omnifox go to Channels and click Connect channel.
  2. Pick the Telnyx Programmable Voice type.
  3. Fill in the form:
    • API Key: the key from Step 1 (from Mission Control -> API Keys).
    • Connection ID: the ID from Step 2.
    • Default From Number (E.164): optional here; covered in its own article.
  4. Save to create the channel.

Step 4: Point the Telnyx webhook to Omnifox

So Telnyx can notify Omnifox about incoming calls, copy the webhook URL Omnifox shows when creating the channel and paste it into your Telnyx connection under Connection -> Webhooks. Save the changes in Telnyx.

How to verify

  • Under Channels, the new Telnyx channel should show as active.
  • Place a real inbound call to your Telnyx number: it should land in Omnifox. A live test catches problems that a successful save won't.
  • If you run a test outbound call, confirm it goes out with your number.

If it doesn't work

  • No calls reach the channel: check the webhook URL in Connection -> Webhooks and that the connection is Call Control type.
  • Authentication error: the API Key is mistyped or was revoked in Telnyx. Generate a new one and paste it again.
  • Invalid Connection ID: make sure you copied the connection's ID, not the number's or the messaging profile's.

Tips

  • Use a dedicated API Key for Omnifox; that way you can revoke it without breaking other integrations.
  • The recommended next step is setting the default number and, for extra security, verifying webhook signatures.

Related articles

Was this helpful?

Related articles

Message us on WhatsApp