Quickstart

This guide walks you through creating your first AI voice agent and making it available on a phone number.

Prerequisites

A Flireo account with an API key

A phone number configured to forward calls to Flireo (contact support for SIP configuration)

Step 1: Get Your API Key

Find your API key in the dashboard under Settings > API Keys. You'll use this for all API requests.

Step 2: Create an Agent

Create a new AI agent with a simple POST request:

Response:

{
  "agent": {
    "id": "17a0cb75-fa09-4bdd-9a44-92a70d829c88",
    "name": "Customer Support Agent",
    "business_name": "Acme Corp",
    "first_message": "Hello, welcome to Acme. How can I help you today?",
    "is_active": true,
    "stt_config": { ... },
    "llm_config": { ... },
    "tts_config": { ... },
    "created_at": "2025-12-13T10:00:00.000Z",
    "updated_at": "2025-12-13T10:00:00.000Z"
  }
}

Save the id - you'll need it to assign a phone number.

Step 3: Register a Phone Number

Response:

{
  "number": {
    "id": "abc12345-1234-5678-9012-abcdef123456",
    "phone_number": "+31850835037",
    "name": "Main Support Line",
    "agent_id": "17a0cb75-fa09-4bdd-9a44-92a70d829c88",
    "created_at": "2025-12-13T10:05:00.000Z"
  }
}

Video guide for Telnyx phone numbers:

Step 4: Test Your Agent

Call the phone number you registered. Your AI agent will answer and greet the caller with the configured first message.

Step 5: View Call History

After the call, view it in your call history:

Response:

{
  "calls": [
    {
      "id": "call-_+31612345678_abc123",
      "caller_phone": "+31612345678",
      "agent_phone": "+31850835037",
      "status": "ended",
      "duration_seconds": 45,
      "summary": "Customer asked about opening hours.",
      "agent_name": "Customer Support Agent",
      "created_at": "2025-12-13T10:10:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 100,
    "offset": 0
  }
}

Next Steps

Configure webhooks to receive real-time call events

Add custom tools to let your agent look up information

Set up BYOK to use your own API keys

Enable call analysis for structured post-call data

Prerequisites#

Step 1: Get Your API Key#

Step 2: Create an Agent#

Step 3: Register a Phone Number#

Video guide for Telnyx phone numbers:#

Step 4: Test Your Agent#

Step 5: View Call History#

Next Steps#

Prerequisites

Step 1: Get Your API Key

Step 2: Create an Agent

Step 3: Register a Phone Number

Video guide for Telnyx phone numbers:

Step 4: Test Your Agent

Step 5: View Call History

Next Steps