Send your first message
This guide sends a WhatsApp text message from your application. You need a Ziph account, a phone with WhatsApp, and a recipient who expects your message.
1. Create an account
Create your account, then open the dashboard. New workspaces receive a seven-day trial with one WhatsApp number and 50 messages. Sending stops when the trial expires or the allowance runs out.
2. Connect WhatsApp
Open Channels and create a WhatsApp channel. Give it a recognizable name, then connect it using a QR code or phone pairing code.
On your phone, open WhatsApp’s Linked devices screen and follow the pairing instructions. Wait for the channel to show Connected before sending. See Channels if you need help connecting.
3. Create an API key
Open API Keys and create a key for your integration. Copy the secret when it is shown; you cannot retrieve it later.
Keep the key on your server. Do not put it in browser code, a mobile app bundle, source control, or a shared screenshot.
4. Send a message
The example below uses the public API at https://api.ziph.dev.
Set ZIPH_API_KEY in your local shell, then run the request. Replace the example recipient with the intended phone number in international format. Use a new idempotency key for each new message.
curl -i 'https://api.ziph.dev/v1/messages' \
-H "Authorization: Bearer $ZIPH_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: first-message-2026-11-19' \
-d '{
"channel_type": "whatsapp",
"to": "+23276123456",
"text": "Hello from Ziph."
}' Without channel_id, Ziph uses your workspace’s default WhatsApp channel. You can choose another channel by including its ID.
A completed new submission returns 201 Created and a message record inside data. Save data.id. Acceptance does not mean the message has been delivered.
5. Inspect the result
Replace MESSAGE_ID with the ID returned by your request:
curl 'https://api.ziph.dev/v1/messages/MESSAGE_ID' \
-H "Authorization: Bearer $ZIPH_API_KEY" The response includes the latest status and its history. You can also inspect the message in the dashboard’s Messages page.
If a request times out, retry with the same idempotency key and unchanged request. Do not switch keys to force a second send. Read Messages for status meanings and safe retries.
Next steps
- Messages: images, buttons, lists, status handling, and errors.
- Webhooks: receive incoming WhatsApp messages.
- API Reference: exact request and response definitions.