Quick Start

Send your first iMessage or SMS in 3 steps.

Step 1: Get Your API Key

Sign up at portal.senderz.com and create your account. Your first API key is generated automatically. Copy it — you’ll need it for every API call.

API keys look like this: tf_live_abc123...

Step 2: Send Your First Message

Using curl:

curl -X POST https://api.senderz.com/v1/messages \
  -H "Authorization: Bearer tf_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+15551234567",
    "channel": "auto",
    "body": "Hello from senderZ!"
  }'

Using JavaScript:

const response = await fetch('https://api.senderz.com/v1/messages', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer tf_live_YOUR_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    to: '+15551234567',
    channel: 'auto',
    body: 'Hello from senderZ!',
  }),
})

const data = await response.json()
console.log(data.message_id) // "01ABCDEF..."

The channel: "auto" parameter tells senderZ to use iMessage if the recipient supports it, and fall back to SMS otherwise.

Step 3: Check Delivery Status

curl https://api.senderz.com/v1/messages/MESSAGE_ID \
  -H "Authorization: Bearer tf_live_YOUR_KEY"

Response:

{
  "message_id": "01ABCDEF...",
  "status": "delivered",
  "channel": "imessage",
  "to": "+15551234567",
  "sent_at": "2026-03-27T10:00:00Z",
  "delivered_at": "2026-03-27T10:00:01Z"
}

Next Steps