---
title: "Quickstart"
description: "Get started with ZeroVoice in 5 minutes — make your first call and send SMS"
canonical: "https://docs.ainative.studio/docs/zerovoice/quickstart"
last-updated: "2026-11-02T18:12:43.468Z"
---

# Quickstart

Source: https://docs.ainative.studio/docs/zerovoice/quickstart

> Get started with ZeroVoice in 5 minutes — make your first call and send SMS

## ZeroVoice Quickstart

Go from zero to your first outbound call in under 10 minutes.

## Prerequisites

- An AINative account with ZeroVoice enabled
- A provisioned phone number (or use the default caller ID)
- A valid JWT token or API key

## 1. Check the system is healthy

```bash
curl https://your-zerovoice-instance.example.com/health/ready
```

Response:
```json
{
  "status": "healthy",
  "db": { "ok": true },
  "twilio": { "ok": true, "account_status": "active" }
}
```

## 2. Authenticate

```bash
## Option A: Login to get a JWT
curl -X POST https://your-instance/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com", "password": "your-password"}'

## Option B: Use an API key
## Pass X-API-Key header instead of Authorization
```

Set the token for subsequent requests:
```bash
export TOKEN="eyJ..."
```

## 3. List your phone numbers

```bash
curl -H "Authorization: Bearer $TOKEN" \
  https://your-instance/api/v1/numbers
```

## 4. Place an outbound call

```bash
curl -X POST https://your-instance/api/v1/calls/outbound \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+18317773598",
    "to_number": "+15551234567",
    "record": true
  }'
```

Response:
```json
{
  "id": "a1b2c3d4-...",
  "from_number": "+18317773598",
  "to_number": "+15551234567",
  "status": "queued",
  "direction": "outbound"
}
```

## 5. Send an SMS

```bash
curl -X POST https://your-instance/api/v1/sms/send \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+18317773598",
    "to_number": "+15551234567",
    "body": "Hi! This is a test from ZeroVoice."
  }'
```

## 6. Create a contact

```bash
curl -X POST https://your-instance/api/v1/contacts \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jamie Carter",
    "phone": "+15551234567",
    "email": "jamie@example.com",
    "company": "Northwind Solar",
    "tags": ["demo", "priority"]
  }'
```

## Next steps

- [API Reference](/docs/zerovoice/api-reference) — Full endpoint documentation
- [MCP Bridge](/docs/zerovoice/mcp-bridge) — Let your AI agents make calls
- [Authentication](/docs/zerovoice/authentication) — JWT details and API keys