6rsh REST API reference

Authentication

Create an API key in your dashboard under Integrations → API Keys (up to 5 keys, shown once, hashed at rest). Pass it on every request:

Authorization: Bearer 6rsh_live_XXXXXXXXXXXX
# or
X-API-Key: 6rsh_live_XXXXXXXXXXXX

Base URL: https://www.6rsh.com/api/v1

Test the connection

curl https://www.6rsh.com/api/v1/ping \
  -H 'Authorization: Bearer 6rsh_live_XXXXXXXXXXXX'

Send a template message

Sends an approved WhatsApp template to up to 50 recipients per call (HTTP 207 on partial success). Use an Idempotency-Key header to make retries safe.

curl -X POST https://www.6rsh.com/api/v1/notifications/send \
  -H 'Authorization: Bearer 6rsh_live_XXXXXXXXXXXX' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: order_12345_v1' \
  -d '{
    "template": "order_confirmation",
    "language": "en",
    "recipients": [{
      "phone": "+9715XXXXXXXX",
      "first_name": "Ahmed",
      "variables": { "1": "Ahmed", "2": "1500 AED" },
      "tags": ["woocommerce"]
    }]
  }'

Reply inside the 24-hour window

Free-text messages are allowed while a customer-service window is open (24 hours after the customer's last message):

curl -X POST https://www.6rsh.com/api/v1/messages/send \
  -H 'Authorization: Bearer 6rsh_live_XXXXXXXXXXXX' \
  -H 'Content-Type: application/json' \
  -d '{ "phone": "+9715XXXXXXXX", "message": "Your order is ready!" }'

More endpoints

Errors

All errors share one envelope:

{
  "success": false,
  "error": {
    "code": "TEMPLATE_NOT_FOUND",
    "message": "Template 'my_template' not found or not approved on Meta.",
    "details": {}
  }
}

Codes: INVALID_API_KEY · PLAN_REQUIRED · TEMPLATE_NOT_FOUND · INVALID_PHONE · SESSION_WINDOW_EXPIRED · RATE_LIMIT_EXCEEDED