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
Body
accountIdstring | nullRequired

Your WhatsApp account ID from RogerRoger

Example: 01234567-89ab-cdef-0123-456789abcdef
phoneNumberstring | nullRequired

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

Example: +31612345678Pattern: ^(\+?[1-9]\d{1,14})$
messagestring | null · min: 1 · max: 4096Required

Message text to send (1-4096 characters)

Example: Hello! This is a test message from our API.
Responses
post
/whatsapp/messages
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": "+31612345678",
  "message": "Hello! This is a test message from our API.",
  "attachments": [
    {
      "url": "https://example.com"
    }
  ]
}

No content

Last updated