Skip to main content
Send your first WhatsApp message through the WSAPI in just a few steps.

​
Prerequisites

  • A WSAPI account — sign up at wsapi.chat
  • A WhatsApp-enabled phone number
  • An API client (curl, Postman, or any HTTP library)
1

Create an account

Head to wsapi.chat and create your account. New accounts automatically receive a free trial with a fully functional instance.
2

Get your API key

Navigate to the Settings -> API Key section in your dashboard. Generate your API key and copy it, you’ll need it for every request.
Keep your API key secret. Never expose it in client-side code or public repositories. Rotate it immediately if you suspect exposure.
3

Pair your WhatsApp instance

Go to Instances, find your instance, and click Pair. Scan the QR code with your phone’s WhatsApp app to connect.Once paired, your instance status changes to Logged In.Copy the Instance ID from the Instance Overview, as you’ll need it for API requests alongside your API Key.
4

Send your first message

Make your first API call to send a WhatsApp message:
curl -X POST https://api.wsapi.chat/messages/text \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "X-Instance-Id: YOUR_INSTANCE_ID" \
  -d '{
    "to": "1234567890@s.whatsapp.net",
    "message": "Hello from WSAPI!"
  }'
Replace 1234567890 with the recipient’s phone number including country code (no + prefix).
5

Configure event delivery

Click Settings on your dashboard to configure how you receive events. Choose between:
  • Webhook — WSAPI sends events to your endpoint via HTTP POST
  • Pull Mode (SSE) — Your app connects to WSAPI via Server-Sent Events
See Configuring Your Instance for details.

​
Next steps

Free Trial

Learn about what’s included in your free trial

API Reference

Explore all available endpoints

SDKs & Libraries

Use our official SDKs for Node.js, .NET, and Python

Events

Receive real-time events from WhatsApp