How to Get Started with WazzAPI: From Sign-Up to Your First Message

Step 1: Sign In to the Dashboard

Head over to https://app.wazzapi.com and sign in with your account. If you're joining an existing workspace, make sure you have access to the correct organization before proceeding — this matters because API keys and WhatsApp account IDs are scoped to the workspace.

Step 2: Connect a WhatsApp Account

Before you can send any messages, you need to link at least one WhatsApp number. In the dashboard, navigate to the WhatsApp Accounts section and connect your number. Once connected, you'll get a whatsapp_account_id — hold onto this, as you'll need it in every API call that sends a message.

Step 3: Create an API Key

Go to Developers in the dashboard sidebar and create a new API key. Give it a descriptive name so you can manage it later. Important: the full secret is only shown once at creation time. Copy it immediately and store it somewhere safe, like a secrets manager or environment variable. Never expose it in frontend code or public repositories.

Step 4: Send Your First Message

With your API key and whatsapp_account_id ready, you can send your first message using a simple HTTP POST request to the WazzAPI endpoint. The base URL is https://api.wazzapi.com. Here's what the request looks like:

POST /api/v1/messages/send

Authorization: Bearer YOUR_API_KEY

Body: { "phone_number": "6281234567890", "content": "Hello from WazzAPI!", "message_type": "text", "whatsapp_account_id": "your-account-uuid", "validate_phone": true }

The validate_phone flag tells WazzAPI to verify the number is a valid WhatsApp account before sending — a handy feature to avoid delivery failures.

Step 5: Track Delivery Status

The response from the send call includes a message_id. You can use this to poll the message status:

GET /api/v1/messages/{message_id}

This returns the current delivery state: sent, delivered, read, or failed. For production use, webhooks are a better option than polling — but for testing, this endpoint is perfect.

What's Next?

Once you've sent your first message, you're ready to explore more advanced capabilities: sending media, location pins, and interactive messages, organizing your contacts, building templates for personalized outreach, and subscribing to real-time webhook events. The WazzAPI documentation at docs.wazzapi.com covers all of these in detail.