Free SMS Marketing API Documentation

Get Your API Key First

Before sending free SMS marketing messages, create a personal API key in the web panel. This key lets your website, CRM, or automation tool call the API directly.

1. Log in to the web panel and go to Settings.
2. Scroll to the API Key section and click Generate Key.
3. Copy the key and use it in the Authorization: Bearer header of your requests.

{
  "status": "ready"
}

How to Send an SMS

Use queue_sms to add an outgoing SMS to the queue. The Android device/app sends it when it polls the API.

curl -X POST "https://api.rcszilla.com/?endpoint=queue_sms" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR-API-KEY" \
  -d "{\"to\":\"+40700000000\",\"message\":\"Hello from RCSZilla\",\"channel\":\"sms\"}"

{
  "success": true,
  "message": "Queued",
  "id": 123
}

API Overview

This is the REST API used by the RCSZilla Android app and web panel for free SMS marketing workflows. Use it to queue outbound messages, report delivery status, submit incoming replies, and synchronize device configuration.

All requests and responses use JSON. All endpoints are served from https://api.rcszilla.com/ and are selected via the ?endpoint= query parameter.

Request Format

Every request must send Content-Type: application/json and an Authorization header (except claim_device, which is public).

POST https://api.rcszilla.com/?endpoint=queue_sms HTTP/1.1
Host: api.rcszilla.com
Content-Type: application/json
Authorization: Bearer YOUR-API-KEY

{"to": "+40700000000", "message": "Hello from RCSZilla", "channel": "sms"}

Response Format

Every response is a JSON object. Successful responses always contain "success": true. Failures contain "success": false and a "message" field.

{
  "success": true,
  "message": "Queued",
  "id": 123
}

{
  "success": false,
  "message": "id required"
}

Quick Reference