API Overview

The Wazera API is a RESTful API that lets you send WhatsApp messages, manage contacts, and trigger automations programmatically.

Base URL

https://app.wazera.com/api/v1

Authentication

All requests require an API key in the X-API-Key header:

curl -H "X-API-Key: wz_live_your_key_here" \
     https://app.wazera.com/api/v1/account/me

Response Format

All responses are JSON with this structure:

Success

{
  "success": true,
  "data": { ... }
}

Error

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The 'to' field is required.",
    "details": { ... }
  }
}

HTTP Status Codes

Code Description
200 OK — Request succeeded
201 Created — Resource created
400 Bad Request — Invalid parameters
401 Unauthorized — Invalid or missing API key
403 Forbidden — Insufficient permissions
404 Not Found — Resource not found
429 Too Many Requests — Rate limit exceeded
500 Internal Server Error

Endpoints

Messages

Method Endpoint Description
POST /messages/send Send a text message
POST /messages/template Send a template message
GET /messages/{id}/status Get message delivery status

Contacts

Method Endpoint Description
GET /contacts List contacts
POST /contacts/create Create a contact
PUT /contacts/{id} Update a contact
GET /contacts/{id} Get a contact

Automations

Method Endpoint Description
POST /automations/trigger Trigger an automation

Account

Method Endpoint Description
GET /account/me Get account info

Pagination

List endpoints support pagination:

GET /api/v1/contacts?page=1&per_page=25

Response includes pagination metadata:

{
  "data": [...],
  "meta": {
    "current_page": 1,
    "per_page": 25,
    "total": 150,
    "last_page": 6
  }
}