Nixflex - AI Voice Platform for Building AI Phone Agents

This guide takes you from zero to a working AI agent answering and making real phone calls. You’ll need:

A Nixflex account
A Twilio or Telnyx account with at least one phone number
A way to make a test call (any mobile phone)

Nixflex is bring your own carrier. Your numbers stay in your own Twilio or Telnyx account, you pay the carrier directly, and Nixflex never marks up or resells them. Everything below works the same on either carrier.

Step 1 - Get your API key

Open dashboard.nixflex.com and sign in. An API key is created for your account automatically.

Reveal your key

Go to API Keys, click Reveal, and copy the full credential. It looks like:

nxf_a1b2c3...:nxfs_x1y2z3...

Use it in requests

Authenticate every API call with:

Authorization: Bearer nxf_xxx:nxfs_xxx

Treat your full credential like a password. Never commit it to source control or expose it in client-side code. If it leaks, rotate immediately from the dashboard.

Step 2 - Create an agent

An agent is the AI personality that answers calls. Each agent has a prompt, voice, language, and behaviour settings.

curl -X POST https://api.nixflex.com/v1/agents \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Test Receptionist",
    "system_prompt": "You are a friendly receptionist for Acme Dental. Greet callers, answer questions about opening hours (Mon-Fri 9am-5pm), and book appointments by collecting name and preferred date.",
    "welcome_message": "Hello, Acme Dental, how can I help?"
  }'

The response contains your agent_id:

{
  "agent_id": "agent_125207e452f8714a",
  "name": "Test Receptionist",
  "voice_id": "Ashley",
  "language": "multi",
  "is_active": true
}

Save the agent_id - you’ll attach a phone number to it next.

The default voice is Ashley and the default language is multi, which follows the caller across English, Spanish, French, German, Italian, Portuguese, Dutch, Hindi, Russian and Japanese. For Arabic, Hebrew, Korean, Chinese or Polish, set language to that code instead. Change either later via the dashboard or the Create agent reference.

Step 3 - Connect a phone number

You import a number you already own. Nixflex works out which carrier it is from the credentials you send - there is no provider field to set.

Set the number up in your carrier account first. Nixflex cannot fix a number that is not provisioned, not voice-enabled, or blocked from your destination countries. If a call fails, the error usually names the carrier setting to change.Carrier consoles also change. Twilio and Telnyx both redesign screens and update policies from time to time, so field names may not match this page exactly. The values Nixflex needs do not change - if a screen looks different, follow your carrier’s own current documentation.

Twilio

Buy a voice-enabled number in your Twilio console, then import it with your Account SID and Auth Token:

curl -X POST https://api.nixflex.com/v1/phone-numbers \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+447446466847",
    "twilio_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "twilio_token": "your_twilio_auth_token",
    "agent_id": "agent_125207e452f8714a"
  }'

Nixflex points that number’s webhooks at the engine. Nothing else to configure.

Full guide: Twilio.

Telnyx

Telnyx needs three things set up in your portal first, because its webhook lives on an application rather than on the number:

Buy or port a voice-enabled number.
Create a TeXML Application - set its voice webhook to https://api.nixflex.com/telnyx-voice, method POST, webhook API version 2. Copy the application ID.
Assign your number to that application, and enable the G711U codec on it (disable HD Voice / G722).
Create an API key with access to the number.

Then import, using the API key and the application ID:

curl -X POST https://api.nixflex.com/v1/phone-numbers \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+443301901028",
    "telnyx_api_key": "KEY0123456789...",
    "telnyx_connection_id": "2512345678901234567",
    "agent_id": "agent_125207e452f8714a"
  }'

Full guide, with the reasoning behind each step: Telnyx.

Prefer clicking to curl? The dashboard does the same thing under Phone Numbers, with a Twilio / Telnyx toggle.

Step 4 - Test inbound

Call your number from any phone. The agent will:

Pick up
Say your welcome message
Listen, respond, handle interruptions naturally
Hang up when the conversation ends or when the caller stops talking

Step 5 - Test outbound

Have the agent call you. Replace the to_number with your mobile.

curl -X POST https://api.nixflex.com/v1/calls/outbound \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_125207e452f8714a",
    "to_number": "+44YOUR_MOBILE"
  }'

Your phone rings within seconds. Pick up and talk to your agent.

You don’t pass a from_number. The engine uses the number you assigned to the agent in Step 3. Outbound works on both carriers.

Step 6 - Read the call back

After the call ends, pull the details:

curl https://api.nixflex.com/v1/calls \
  -H "Authorization: Bearer YOUR_KEY"

The response includes the transcript, recording URL, post-call summary, caller sentiment, and any custom data the agent extracted. See List calls for every field.

What’s next

Telephony setup

Full carrier guides for Twilio and Telnyx, including what each one supports.

Agent actions

Let your agent transfer calls, send SMS, and end calls using prompt tags.

Webhooks

Receive post-call data in your own systems automatically.

Custom functions

Let the agent call your APIs mid-call (lookup, booking, payments).

Get started

Guides

Best practices

Core concepts

In-call actions

Features

SMS

Reference

Quickstart

Step 1 - Get your API key

Step 2 - Create an agent

Step 3 - Connect a phone number

Twilio

Telnyx

Step 4 - Test inbound

Step 5 - Test outbound

Step 6 - Read the call back

What’s next

Telephony setup

Agent actions

Webhooks

Custom functions

​Step 1 - Get your API key

​Step 2 - Create an agent

​Step 3 - Connect a phone number

​Twilio

​Telnyx

​Step 4 - Test inbound

​Step 5 - Test outbound

​Step 6 - Read the call back

​What’s next

Telephony setup

Agent actions

Webhooks

Custom functions

Step 1 - Get your API key

Step 2 - Create an agent

Step 3 - Connect a phone number

Twilio

Telnyx

Step 4 - Test inbound

Step 5 - Test outbound

Step 6 - Read the call back

What’s next