# API Reference

> The WhatsAble API: send WhatsApp messages and manage templates, contacts, broadcasts and AI bots from your own code. Start with API v1. The legacy API stays documented for existing integrations.

> [!NOTE]
>
> The WhatsAble API gives your code the same WhatsApp Business account that your team uses in WhatsAble. Use it from your own server, or connect WhatsAble through Zapier, Make or n8n without code.

## Start with API v1

API v1 is the API for every new integration. It sends text, template, media and button messages, reads conversations and delivery status, manages contacts and labels, creates templates, schedules messages, launches broadcasts, and configures AI bots.

- [API v1 overview](/api-reference/v1): 
The base URL, authentication, request format, pagination and errors. Read this first.

- [Send a message](/api-reference/v1/messages/send-message): 
<div className="flex items-center gap-2">
  **
POST
**
  <span className="text-sm text-fd-muted-foreground">Send text, a template, media or buttons</span>
</div>

- [List templates](/api-reference/v1/templates/list-templates): 
<div className="flex items-center gap-2">
  **
GET
**
  <span className="text-sm text-fd-muted-foreground">Get your templates and their review status</span>
</div>

- [API errors](/api/errors): 
Every error code that the API answers with, and what to do about it

## Legacy API

The legacy API keeps working for integrations that already use it. Each legacy page opens with a link to the API v1 operation that replaces it. Build new integrations on API v1.

- [Get Templates](/api-reference/legacy/templates/get-templates): 
<div className="flex items-center gap-2">
  **
GET
**
  <span className="text-sm text-fd-muted-foreground">Retrieve all templates for your account (legacy)</span>
</div>

- [Send Template Message](/api-reference/legacy/templates/send-template-message): 
<div className="flex items-center gap-2">
  **
POST
**
  <span className="text-sm text-fd-muted-foreground">Send template-based messages to users (legacy)</span>
</div>

## Why WhatsAble

- **Meta-Approved**: 
Official WhatsApp Business Platform integration. WhatsAble is an official Meta Tech Provider.

- **Instant Automation**: 
Send customized messages in real time with webhooks and event-driven workflows.

- **Developer & No-Code**: 
A REST API for your own integrations, plus ready-made apps for Zapier, Make and n8n.

- **Business Communication**: 
Alerts, confirmations, reminders and conversations with customers, all on WhatsApp.

## Connect your way

Connect through a no-code automation platform, or call the API directly.

- [Zapier](/integration/zapier): 
Connect 6,000+ apps with Zaps. No code needed.

- [Make](/integration/make): 
Build visual automation scenarios with drag-and-drop workflows.

- [n8n](/integration/n8n): 
Self-hosted or cloud workflows with full control over your automation.

- [Direct API](/api-reference/v1): 
REST endpoints with API keys. Full access from your own code.

## Get started

**Create your account**

Create a WhatsAble account at [console.whatsable.app/sign-up](https://console.whatsable.app/sign-up).

**Connect a WhatsApp number**

Open [**Settings → Channels**](https://console.whatsable.app/settings/channels) and select **Add channel**, then **WhatsApp**. The API cannot send until one number is connected. See [Embedding Process](/get-started/embedding).

**Create an API key**

Open [**API keys**](https://console.whatsable.app/settings/api-keys) and select **Create API key**. Choose the number that the key sends from. A key can also use all numbers or a few numbers that you choose. Only owners and admins can create keys.

**Call the API**

Send the key in the `Authorization` header as a bearer token. See [Authentication](/api-reference/v1#authentication) in the API v1 overview.

> [!WARNING]
>
> **Security:** Never put an API key in client-side code or in a public repository. Anyone with the key can message your contacts. Keep the key in an environment variable and call the API from your server only.