Quickstart

Create an account

Sign up at app.boltly.online/register. You'll get a free organization with a 14-day trial of all features — no credit card required.

Connect your WhatsApp number

In the dashboard, go to Settings → WhatsApp Setup and click Connect WhatsApp. This opens Meta's embedded signup where you'll:

1. a Log in with your Facebook Business account
2. b Select or create a WhatsApp Business Account (WABA)
3. c Register a phone number for the API

Once complete, you'll be redirected back. Your setup status should show connected.

Get your API key

Navigate to Settings → Developer Access → API Keys and create a new key. For testing, select all scopes.

Your key authenticates via the X-API-Key header. See Authentication for details on scopes and JWT tokens.

Send your first message

Replace the API key and phone number below. The contact must have messaged your WhatsApp number first (Meta requirement for non-template messages).

curl -X POST https://api.boltly.online/v1/messages \
  -H "X-API-Key: sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+1234567890",
    "type": "text",
    "text": { "body": "Hello from Boltly!" }
  }'

Response

{
  "data": {
    "id": "msg_01H2X3K...",
    "to": "+1234567890",
    "type": "text",
    "status": "queued",
    "created_at": "2026-04-03T12:00:00Z"
  }
}

A queued status means WhatsApp accepted the message. It will be delivered within seconds. Subscribe to webhooks to track delivery and read receipts.