> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dialbird.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Dialbird API

> A versioned, machine-to-machine REST API for building automations on top of Dialbird.

The Dialbird Public API is a versioned, machine-to-machine REST surface for building automations on top of Dialbird — from no-code tools like Zapier, n8n, and Make to custom scripts and backend services.

## Base URL

All endpoints live under the versioned `/api/v1` path:

```
https://api-prod.dialbird.io/api/v1
```

## What you can do

<Columns cols={2}>
  <Card title="Manage contacts" icon="address-book" href="/concepts/conventions">
    Create and update contacts in your business with the same match-and-merge behavior as the app.
  </Card>

  <Card title="Send SMS" icon="message-sms" href="/getting-started/quickstart">
    Queue outbound text messages and track delivery through webhooks.
  </Card>

  <Card title="Subscribe to events" icon="webhook" href="/concepts/webhooks">
    Receive signed webhook deliveries for inbound/outbound messages and completed calls.
  </Card>

  <Card title="Verify identity" icon="id-card" href="/getting-started/authentication">
    Resolve the business, user, and scopes behind an access token with `GET /me`.
  </Card>
</Columns>

## How requests work

* **Authentication** — Every endpoint except `GET /health` requires an OAuth 2.0 bearer token. See [Authentication](/getting-started/authentication).
* **JSON, snake\_case** — All request and response bodies are JSON with `snake_case` fields. See [Conventions](/concepts/conventions).
* **Safe retries** — Write endpoints accept an `Idempotency-Key`. See [Idempotency](/concepts/idempotency).
* **Predictable errors** — Every error shares one envelope with a stable `code`. See [Errors and rate limits](/concepts/errors).

## Next steps

<Columns cols={2}>
  <Card title="Authenticate" icon="key" href="/getting-started/authentication">
    Obtain an access token via the OAuth 2.0 Authorization Code flow.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/getting-started/quickstart">
    Confirm your token, send your first SMS, and subscribe to an event.
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.