---
sidebar_position: 3
title: Quickstart
description: Make your first API call to the Firetell platform in under 5 minutes.
---

# Quickstart

Get up and running with the Firetell API in just a few minutes.

## Prerequisites

- A [Firetell Console](https://console.firetell.com) account
- An API key (see [Authentication](/docs/getting-started/authentication))
- `curl` or any HTTP client

## Step 1: Find Your Workspace Domain

Each workspace has its own API domain. To find yours:

1. Log in to [Firetell Console](https://console.firetell.com)
2. Select your workspace
3. Go to **Workspace Settings** → **General**
4. Note the **Domain** value (e.g., `yourcompany`)

Your API base URL will be:

```
https://{workspace_id}.firetell.app/api/v1
```

:::tip
Replace `yourcompany` in all the examples below with your actual workspace domain.
:::

## Step 2: List Phone Numbers

Verify your API key works by listing the phone numbers in your workspace:

```bash
curl -X GET "https://{workspace_id}.firetell.app/api/v1/phone-numbers" \
  -H "Authorization: ApiKey YOUR_API_KEY"
```

**Response:**

```json
{
  "data": [
    {
      "id": "pn_abc123",
      "number": "+84901234567",
      "type": "local",
      "status": "active"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20
}
```

## Step 3: Make a Call

Initiate an outbound call:

```bash
curl -X POST "https://{workspace_id}.firetell.app/api/v1/calls/make" \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": {
      "number": "+84901234567",
      "name": "Customer Support"
    },
    "to": {
      "number": "+84909876543",
      "name": "John Doe"
    }
  }'
```

## What's Next?

Now that you've made your first API call, explore the full capabilities:

- [REST API Overview](/docs/rest-api/overview) — Learn about all available endpoints
- [Call Flows](/docs/rest-api/workspace-api/call-flows) — Build automated call routing
- [Webhooks](/docs/webhooks/overview) — Receive real-time event notifications
- [Voice Agents](/docs/rest-api/workspace-api/voice-agents) — Integrate AI-powered voice bots