Flireo AI
WebsiteLinkedin
WebsiteLinkedin
  1. Numbers
  • API Reference
    • Agents
      • List all agents
      • Create a new agent
      • Get an agent
      • Update an agent
      • Delete an agent
    • Tool Templates
      • List all tool templates
      • Create a new tool template
      • Get a tool template
      • Update a tool template
      • Delete a tool template
    • Numbers
      • List all phone numbers
        GET
      • Register a phone number
        POST
      • Get a phone number
        GET
      • Update a phone number
        PATCH
      • Delete a phone number
        DELETE
    • Calls
      • List calls
      • Get call by ID
      • Initiate outbound call
    • Call Control
      • Send control command to active call
    • Usage
      • Get usage logs
    • SIP Trunks
      • List SIP trunks
      • Create a SIP trunk
      • Get a SIP trunk
      • Delete a SIP trunk
    • Voices
      • List available voices
    • BYOK
      • Get BYOK configurations
      • Add BYOK configuration
      • Delete BYOK configuration
      • Get BYOK provider configurations
    • Domains
      • Get your domain
      • Add a domain
      • Delete your domain
      • List available Resend domains
      • Select and sync a Resend domain
      • Verify domain DNS records
      • Refresh domain status
    • Webhooks
      • Dynamic assistant configuration webhook
      • Tool/Function Call
      • Call Status Update
      • End of Call Report
    • Analysis Templates
      • List analysis templates
      • Create analysis template
      • Get analysis template
      • Update analysis template
      • Delete analysis template
    • Organization
      • Get organization information
    • Campaigns
      • List all campaigns
      • Create a campaign
      • Get a campaign
      • Update a campaign
      • Delete a campaign
      • List campaign leads
      • Add a lead
      • Remove a lead
  • Documentation
    • Get started
      • Quickstart
      • Introduction
      • Authentication
    • Core concepts
      • Agents
      • Phone numbers
      • Calls
      • Webhooks
    • Api's
      • Organization
      • Agents
      • Phone numbers
      • Sip trunks
      • Calls
      • Call control
      • Usage
      • Voices
      • BYOK
      • Domains
      • Analysis templates
      • Tool templates
    • Webhooks
      • Overview
      • Assistant request
      • Tool calls
      • Status update
      • End of call report
      • Security
    • Guides
      • BYOK Setup
      • Call analysis
      • Custom Tools
      • Call Transfers
      • xAI Realtime Integration
      • Analysis templates
      • Billing
      • Error codes
      • Rate limits
      • Sip Trunks
      • Tool templates
      • Troubleshooting
WebsiteLinkedin
WebsiteLinkedin
  1. Numbers

Register a phone number

POST
https://api.flireo.com/api/v1/numbers
Numbers
Last modified:2026-01-09 14:25:39
Maintainer:Not configured
Register a new phone number in your organization. The number must be configured with your SIP provider to forward calls to Flireo.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
Phone number registered successfully
Body

🟠409BadRequest
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.flireo.com/api/v1/numbers' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "phone_number": "+31850835037",
    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
    "transfer_trunk_id": "ffebe614-a59e-4332-b99b-9c8f0b1671f9",
    "is_active": true
}'
Response Response Example
201 - Example 1
{
    "number": {
        "number": "+31850835037",
        "name": "Flireo Demo"
    }
}
Modified at 2026-01-09 14:25:39
Previous
List all phone numbers
Next
Get a phone number
Built with