Skip to main content

Introduction

Welcome to the Firetell Developer Platform. Firetell provides a suite of cloud communications APIs that enable you to build voice-powered applications, automate call workflows, and integrate intelligent voice agents into your products.

What is Firetell?​

Firetell is a Communications Platform as a Service (CPaaS) that offers:

  • Cloud Phone Numbers — Provision and manage virtual phone numbers worldwide
  • Programmable Voice — Make, receive, and control calls via API
  • Smart IVR / Call Flows — Build drag-and-drop interactive voice response systems
  • SIP Trunking — Connect your existing PBX infrastructure to the cloud
  • Call Center — Manage agents, teams, queues, and call routing
  • Voice AI — Deploy AI-powered voice agents for customer interactions
  • Call Recording — Record and store call audio for compliance and quality assurance
  • Webhooks — Receive real-time event notifications

Who is this for?​

This documentation is designed for developers who want to integrate Firetell's capabilities into their applications using our REST APIs, webhooks, and SDKs.

Base URL​

Each workspace has its own unique API domain. The base URL for all developer API requests follows this pattern:

https://{workspace_id}.firetell.app/api/1.0

Replace {workspace_id} with your workspace's subdomain. To find it:

  1. Log in to Firetell Console
  2. Select your workspace
  3. Go to Workspace Settings → General
  4. Copy the Domain value

For example, if your domain is yourcompany, your base URL would be:

https://yourcompany.firetell.app/api/1.0

Authentication​

Firetell APIs use Bearer Token authentication. You can generate API keys from the Firetell Console.

curl -X GET "https://yourcompany.firetell.app/api/1.0/phone-numbers" \
  -H "Authorization: Bearer YOUR_API_KEY"

See the Authentication guide for more details.

Next Steps​