Quickstart
From sign-up to your first message, in about ten minutes.
Create your account
Sign up with your business name, an email and a password. Your workspace opens on a 14-day free trial: one WhatsApp number, its full message allowance, REST API and webhooks included. No card required.
Connect your WhatsApp number
From your dashboard, open Connections. You will find a unique URL there. Open it to connect your own number through Meta's Embedded Signup — or send it to a business whose numbers you manage.
The account, its numbers and its templates then appear in your workspace automatically.
Already using the WhatsApp Business app?
You can keep the app on your phone while plugging the API into the same number: that is coexistence mode. Your conversations stay in sync both ways. The one difference to know: send throughput is capped at 20 messages per second.
Create an API key
Still in the dashboard, under Developers, generate a key. It is shown once — copy it immediately.
Send your first message
First, look up the connection you want to send from:
curl https://wa.genuka.com/api/v1/connections \
-H "Authorization: Bearer $GENUKA_WA_API_KEY"Then send:
curl https://wa.genuka.com/api/v1/messages \
-H "Authorization: Bearer $GENUKA_WA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"connectionId": "cnx_...",
"to": "+237699001122",
"text": "Hello from Genuka WA 👋"
}'This first send only works if the recipient messaged you within the last 24 hours. Otherwise you need an approved template — see Sending messages.
Receive replies
In the portal, under Webhooks, register your application's URL and pick the events you want. The signing secret is shown once — copy it.
Every delivery is signed; your endpoint must verify that signature before processing anything. See Webhooks.
Next
- Authentication — API keys, scope, rotation.
- Sending messages — every available type and the 24-hour rule.
- Webhooks — events, signature, replay.