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

# Messages

> Send text messages and read outgoing message history.

Before sending, the token must be paired and live-connected:

```json theme={null}
{
  "paired": true,
  "connected": true
}
```

If a token is paired but `connected` is `false`, call `POST /api/v1/sessions/{sessionId}/connect` first. This reconnects the existing WhatsApp credentials.

## Send text

```http theme={null}
POST /api/v1/sessions/{sessionId}/messages
Authorization: Bearer <api_key>
Content-Type: application/json
Idempotency-Key: <unique-message-key>
```

```json theme={null}
{
  "to": "15551234567",
  "content": {
    "type": "text",
    "text": "Your order is ready."
  }
}
```

## List outgoing messages

```http theme={null}
GET /api/v1/sessions/{sessionId}/messages
Authorization: Bearer <api_key>
```