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

# Messaging API

> Send and retrieve messages with A1Zap

## Messaging API

Use these endpoints to send individual messages and fetch recent messages.

### Send an Individual Message

Replace placeholders like `<YOUR_API_KEY>`, `<AGENT_ID>`, and `<CHAT_ID>` with your values.

```bash theme={null}
curl -X POST "https://api.a1zap.com/v1/messages/individual/<AGENT_ID>/send" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -d '{
  "metadata" : {
    "source" : "ios"
  },
  "chatId" : "<CHAT_ID>",
  "content" : "Hello from the API!"
}'
```

### Get Messages (via Agent Webhook Runner)

```bash theme={null}
curl -X POST "https://api.a1zap.com/api/run/agentWebhook/getMessages" \
  -H "Content-Type: application/json" \
  -d '{
  "args" : {
    "agentId" : "<AGENT_ID>",
    "apiKey" : "<YOUR_API_KEY>",
    "chatId" : "<CHAT_ID>",
    "limit" : 25
  },
  "format" : "json"
}'
```

#### Notes

* `X-API-Key` should be an API key with permissions to send/read messages for the target agent.
* `chatId` identifies the conversation thread.
* `metadata.source` is optional and can be used for analytics/debugging.