Whatsapp messages

Send WhatsApp message

post

Send a WhatsApp message to any phone number using your connected WhatsApp account.

Rate Limits (per account):

• Burst: 6 messages capacity (refills 1 token every 20 seconds = 3/min)

• Hourly: 60 messages per hour (sliding window)

Response Headers:

• X-RateLimit-Burst-Limit: Maximum burst capacity

• X-RateLimit-Burst-Remaining: Remaining burst tokens

• X-RateLimit-Hour-Limit: Maximum messages per hour

• X-RateLimit-Hour-Remaining: Remaining hourly quota

• Retry-After: Seconds to wait if rate limited (429 response)

Processing: Messages are processed asynchronously. The endpoint returns 201 immediately and processing happens in the background.

Authorizations

BearerAuthApiKeyAuth

Body

application/ld+jsonapplication/json

accountIdstring · nullableRequired

Your WhatsApp account ID from RogerRoger

Example: 01234567-89ab-cdef-0123-456789abcdef

phoneNumberstring · nullableRequired

Recipient phone number in E.164 format (with country code)

Example: [phone]Pattern: ^(\+?[1-9]\d{1,14})$

messagestring · min: 1 · max: 4096 · nullableRequired

Message text to send (1-4096 characters)

Example: Hello! This is a test message from our API.

Responses

201

Message queued successfully. Check rate limit headers for remaining quota.

400

Validation error (invalid UUID, phone format, or message length)

401

Unauthorized (invalid JWT token or API key)

403

Forbidden

404

WhatsApp account not found or access denied

422

An error occurred

429

Rate limit exceeded. Check Retry-After header for wait time in seconds.

post

/whatsapp/messages

HTTPcURLJavaScriptPython

POST /whatsapp/messages HTTP/1.1
Host: api.rogerroger.io
Content-Type: application/ld+json
Accept: */*
Content-Length: 183

{
  "accountId": "01234567-89ab-cdef-0123-456789abcdef",
  "phoneNumber": "[phone]",
  "message": "Hello! This is a test message from our API.",
  "attachments": [
    {
      "url": "https://example.com"
    }
  ]
}

application/ld+jsonapplication/json

No content