DevDocs

authentication

Authentication & Setup

Get started with our API by creating an account, setting up an instance, and obtaining your API key. Follow the quick start guide below to authenticate your requests.

Onboarding Flow

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 Generation

Your unique x-api-key is generated instantly. Keep this secure; it authorizes all your requests.

5

Listen for Events

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

Secure Header

All REST API calls must include your API key in the request headers.

// Authorize your requests
x-api-key: wa_sk_your_private_key

Response Codes

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