SendWizz API

authentication

Authentication & Setup

Get started with our API by creating an account, setting up an instance, and obtaining your API key. Each API key is bound to one WhatsApp instance. All requests must be made over HTTPS.

Integration Workflow

1

Create an Account

Sign up on the SendWizz platform to get started with your automation journey.

2

Initialize Instance

Navigate to the dashboard and create a new WhatsApp Instance. Each instance acts as a dedicated session.

3

Device Pairing

Scan the secure QR code with your mobile device. This establishes a permanent linked session.

4

API Key (per instance)

Each instance has its own wsk_... API key on the instance page. That key only works for that instance — use it without instance_id, or ensure instance_id / URL :id matches.

5

Listen for Events

Configure a Webhook URL to receive real-time notifications for incoming messages and delivery status.

Secure Authentication

Each WhatsApp instance has a dedicated API key (wsk_...). Pass it as x-api-key or Authorization: Bearer wsk_.... Do not send an instance_id for a different instance than the key belongs to.

// Authorization Header
x-api-key:wsk_your_private_key

HTTP Responses

401Unauthorized - Missing or invalid API key
{
  "success": false,
  "message": "Unauthorized",
  "error": "Missing authorization header"
}