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

# WaMatrix Reseller REST API — Reference and Quick Start

> Explore the WaMatrix REST API to manage client workspaces, send WhatsApp messages, sync contacts, and run broadcast campaigns at scale.

The WaMatrix REST API gives you programmatic access to your reseller account and client workspaces. Use it to automate workspace provisioning, sync contacts, send messages, and manage campaigns without touching the dashboard.

## Base URL

```
https://api.wamatrix.io/v1
```

## Authentication

All requests require a Bearer token in the `Authorization` header. See the [Authentication](/api/authentication) page for how to generate and use API keys.

## Request Format

All request bodies must be JSON with `Content-Type: application/json`. Path and query parameters are plain URL-encoded strings.

## Response Format

All responses return JSON. Successful responses include a `data` field. Errors return an `error` object with `code` and `message`. HTTP status codes follow REST conventions.

**Successful response:**

```json theme={null}
{
  "data": {
    "id": "ws_01hx3g5r8f0q2k7d",
    "name": "Acme Corp",
    "status": "active"
  }
}
```

**Error response:**

```json theme={null}
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired API key."
  }
}
```

## Rate Limits

API requests are rate-limited per API key. The standard limit is **100 requests per minute**. If you exceed the limit, you receive a `429 Too Many Requests` response with a `Retry-After` header indicating how many seconds to wait before retrying. For higher limits, contact support.

## API Keys and Scopes

API keys are scoped to either your reseller account (full access) or individual workspaces (workspace-scoped). Use workspace-scoped keys when building integrations for individual clients. Learn more on the [Authentication](/api/authentication) page.

## Available Resources

<CardGroup cols={2}>
  <Card title="Workspaces" icon="building" href="/api/workspaces">
    Create, retrieve, update, and delete client workspaces on your reseller account.
  </Card>

  <Card title="Contacts" icon="address-book" href="/api/contacts">
    Manage contacts within a workspace — create, import, update, and segment.
  </Card>

  <Card title="Messages" icon="message" href="/api/messages">
    Send individual WhatsApp messages and retrieve message history.
  </Card>

  <Card title="Campaigns" icon="bullhorn" href="/api/campaigns">
    Create and manage broadcast campaigns to reach contacts at scale.
  </Card>

  <Card title="Templates" icon="file-lines" href="/api/templates">
    Manage approved WhatsApp message templates for structured messaging.
  </Card>
</CardGroup>