Getting started

wapower is a multi-tenant WhatsApp gateway API. Send your first message in three steps.

1. Create an account and a key

Register, then create a Personal Access Token (PAT):

curl -X POST https://api.wapower.it/v1/auth/register \
  -H 'content-type: application/json' \
  -d '{"email":"you@example.com","password":"<strong-password>"}'

# log in and create a PAT (or use POST /v1/account/keys)
curl -X POST https://api.wapower.it/v1/account/keys \
  -H 'Authorization: Bearer <session-jwt>' \
  -H 'content-type: application/json' \
  -d '{"name":"my-first-key"}'
# → save the returned token: wap_pat_<hex>.<secret>

New accounts start a 7-day free trial (no card), with Starter limits (1 number).

2. Create a session and scan the QR

curl -X POST https://api.wapower.it/v1/sessions \
  -H 'Authorization: Bearer <PAT>' -H 'content-type: application/json' \
  -d '{"name":"main"}'
# then connect and fetch the QR to scan with WhatsApp on your phone:
curl -X POST https://api.wapower.it/v1/sessions/<id>/connect -H 'Authorization: Bearer <PAT>'
curl https://api.wapower.it/v1/sessions/<id>/qr -H 'Authorization: Bearer <PAT>'

Every new session starts with 🛡 Number Protection ON (warm-up). This is on by design — see Protection.

3. Send a message (3 lines)

curl -X POST https://api.wapower.it/v1/messages/text \
  -H 'Authorization: Bearer <PAT>' -H 'content-type: application/json' \
  -d '{"session_id":"<id>","to":"<E.164-number>","text":"Hello from wapower"}'

That's it. Next: Authentication · Protection · API reference.