GET/quickstart—200OK

Send your first message in 5 minutes

// Follow these four steps to create an account, connect your WhatsApp number, and send a message via the API.

step/01-account.sh
ready
1 $wsapi register --create-account

Sign up for a free WSAPI account using your email, Google, or GitHub credentials. No credit card is required to start your 14-day trial.

step/02-instance.sh
ready
2 $wsapi instance create --pair

After registering, you'll be taken directly to the pairing page. Scan the QR code with your phone to connect your WhatsApp account; the pairing guide covers re-pairing and session expiry. You can also access this anytime from the /dashboard.

step/03-credentials.sh
ready
3 $wsapi instance get-credentials

Copy your Instance ID from the instance detail page. Then generate your API Key in /app/settings. These two values authenticate every API request.

x-api-key: YOUR_API_KEY
x-instance-id: YOUR_INSTANCE_ID
step/04-send-message.sh
ready
4 $wsapi message send --text

Use the following cURL command to send a text message. Replace the placeholder values with your actual credentials and the recipient phone number (including country code, no + or spaces). The quickstart in the docs runs the same flow with the response payloads spelled out.

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",
    "text": "Hello from WSAPI!"
  }'
✓ 200 OK: Message delivered. Response includes the message ID.

$ wsapi docs --open

Want to explore more?

// The full API reference covers every endpoint, webhook event, and configuration option.

Related reading

send-whatsapp-messages-nodejs-2026.mdx
ready
tutorialnodejs

How to Send WhatsApp Messages with Node.js

Send WhatsApp messages from Node.js in five minutes: install the SDK, send text and images, and receive incoming messages over SSE. Full working code.

September 7, 2026|4 min read
send-whatsapp-messages-php-laravel-2026.mdx
ready
phplaraveltutorial

Send WhatsApp Messages with PHP and Laravel

A working WhatsApp API integration in PHP, with a Laravel service class and a webhook receiver that verifies signatures properly. No SDK required.

September 21, 2026|4 min read
whatsapp-otp-verification-python.mdx
ready
pythonsecuritytutorial

How to Send WhatsApp OTP Codes (and Verify Them Safely)

Send one-time verification codes over WhatsApp from Python, with the parts most tutorials skip: hashed storage, expiry, attempt limits, and an SMS fallback.

September 28, 2026|4 min read
twilio-whatsapp-alternative.mdx
ready
comparisonpricing

Twilio WhatsApp Alternative: Flat Pricing, Five Minutes

Looking for a Twilio WhatsApp alternative? Compare per-message fees with flat per-instance pricing, and see the same send in code for both. Free 14-day trial.

October 12, 2026|4 min read
whatsapp-buttons-and-lists-api.mdx
ready
tutorialinteractive-messages

WhatsApp Buttons and Lists API for Any Account

Send WhatsApp reply buttons, link buttons and pick-one lists with two REST calls, and read the choice back as an event. No Business API account.

October 15, 2026|4 min read
whatsapp-chatbot-api-buttons-nodejs.mdx
ready
tutorialchatbotnodejs

WhatsApp Chatbot API: A Button-Driven Bot in Node.js

Build a WhatsApp chatbot with a REST API: verify webhooks, answer with tappable buttons and route the replies. Working Node.js code, about 60 lines.

October 19, 2026|5 min read

Explore more