Skip to main content
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

​
Authentication

All requests require a Bearer token in the Authorization header. See the 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:
Error response:

​
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 page.

​
Available Resources

Workspaces

Create, retrieve, update, and delete client workspaces on your reseller account.

Contacts

Manage contacts within a workspace — create, import, update, and segment.

Messages

Send individual WhatsApp messages and retrieve message history.

Campaigns

Create and manage broadcast campaigns to reach contacts at scale.

Templates

Manage approved WhatsApp message templates for structured messaging.