# Quickstart

URL: https://wa.genuka.com/en/docs/quickstart
Language: English

> From sign-up to your first message, in about ten minutes.

1. ### Create your account

   Sign up with your business name, an email and a password. Your workspace opens on a 7-day free
   trial: one WhatsApp number, its full message allowance, REST API and webhooks included. No card
   required.

2. ### 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.

   > [!NOTE]
   > **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.

3. ### Create an API key

   Still in the dashboard, under **Developers**, generate a key. It is shown **once** — copy it
   immediately.

4. ### Send your first message

   First, look up the connection you want to send from:

   ```bash
   curl https://wa.genuka.com/api/v1/connections \
     -H "Authorization: Bearer $GENUKA_WA_API_KEY"
   ```

   Then send:

   ```bash
   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 👋"
     }'
   ```

   > [!WARNING]
   > This first send only works if the recipient messaged you within the last **24 hours**.
   > Otherwise you need an approved template — see [Sending messages](https://wa.genuka.com/en/docs/messages).

5. ### 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](https://wa.genuka.com/en/docs/webhooks).

## Next

* [Authentication](https://wa.genuka.com/en/docs/authentication) — API keys, scope, rotation.
* [Sending messages](https://wa.genuka.com/en/docs/messages) — every available type and the 24-hour rule.
* [Webhooks](https://wa.genuka.com/en/docs/webhooks) — events, signature, replay.
