Overview

Rewrite API v1 exposes public project endpoints for sending SMS, verifying OTPs, managing templates and webhooks, and reading request logs and webhook deliveries.

Base URL

All public endpoints live under:

https://api.rewritetoday.com/v1

Authentication

Public routes use your API key:

Authorization: Bearer rw_...

Request conventions

Use Content-Type: application/json on non-GET requests.
Public send and OTP flows accept either a direct E.164 number in to or a saved project contact in contact.
Message creation uses content for inline SMS bodies.
Template-backed sends use templateId plus variables.
Message and template metadata are key/value objects, not arrays of pairs.
Create/send routes support Idempotency-Key.

Example request:

curl -X POST "https://api.rewritetoday.com/v1/messages" \
  -H "Authorization: Bearer rw_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: msg:login-otp:2026-05-06T18:30" \
  -d '{
    "to": "+5511999999999",
    "content": "Rewrite: your verification code is 123456",
    "tags": {
      "flow": "login",
      "origin": "checkout"
    }
  }'

Response conventions

Successful responses use the ok / data envelope:

{
  "ok": true,
  "data": {
    "id": "748395130237498500",
    "createdAt": "2026-05-06T18:30:00.000Z",
    "analysis": {
      "characters": 39,
      "encoding": "gsm7",
      "segments": {
        "concat": 153,
        "count": 1,
        "reason": "fits",
        "single": 160
      }
    },
    "sandbox": false
  }
}

Paginated list routes return a top-level cursor.

Public event model

Delivery lifecycle now includes message.delivered.
Inbound traffic is represented by message.received.
Webhook deliveries are documented under Deliveries, including GET /deliveries and GET /webhooks/{id}/deliveries.

Reference

Messages

API Keys

Contacts

Segments

OTP

Tags

Templates

Webhooks

Logs

Deliveries

Introduction

Overview

Base URL

Authentication

Request conventions

Response conventions

Public event model

References

​Overview

​Base URL

​Authentication

​Request conventions

​Response conventions

​Public event model

​References

Overview

Base URL

Authentication

Request conventions

Response conventions

Public event model

References