Skip to content

Documentation

Everything you need to integrate Wazen into your application.

Complete reference for the Wazen REST API v1.

OpenAPI JSON OpenAPI YAML

Authentication

All API requests require an API key passed in the Authorization header:

Authorization: Bearer wz_your_api_key

Create API keys in your Dashboard. Base URL: https://wazen.dev/api/v1

Navigate Endpoints
POST/api/v1/api-keys

Create API key

Generate a new API key for authenticating requests. The raw key is returned only once in the response — store it securely. All subsequent requests use this key in the Authorization header.

Parameters

namerequired
stringin body

A descriptive name for the key (1-255 characters)

Request Body

{
  "name": "production-key"
}

Response

The raw key is included only in the creation response. Store it immediately.

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "production-key",
    "key": "wz_a1b2c3d4e5f6...",
    "created_at": "2026-03-21T12:00:00Z"
  }
}

Code Examples

curl -X POST https://wazen.dev/api/v1/api-keys \
  -H "Authorization: Bearer wz_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "production-key"}'

All endpoints

Every endpoint in the API. Pick one to see its parameters, responses and code examples.

Sessions

Messages

Groups

Channels

Warming

Webhooks