Blue Replies

Documentation

BlueReplies API

Programmatic iMessage. Send blue bubbles, receive replies, build automations. REST API, official Node SDK, webhooks, a free sandbox to test against your own phone.

Quickstart

Send your first iMessage in under 60 seconds.

Sandbox

Free test environment. Activate by texting one code from your phone.

Authentication

API keys, header format, sandbox vs production prefixes.

Webhooks

29 events, HMAC-SHA256 signing, automatic retries with backoff.

Send your first message

Sandbox accounts can message your own activated phone immediately. Pick a language:

curl -X POST 'https://api.bluereplies.com/v1/messages' \
  -H 'x-api-key: sk_sandbox_…' \
  -H 'Content-Type: application/json' \
  -d '{
    "to": "+15551234567",
    "body": "Hello from BlueReplies!"
  }'

No account yet?

Sign up for a free sandbox. Text the activation code we show you, and you'll have a working API key + receive your own test messages within 30 seconds.

What you can build

Conversational messaging

  • Send + receive text, images, voice notes
  • iMessage effects (slam, fireworks, balloons, invisible ink)
  • Tapbacks / reactions on any message
  • Typing indicators and read receipts
  • Reply to specific messages with threading
  • Edit messages (within Apple's 15-minute window)
  • Unsend messages (within Apple's 2-minute window)

FaceTime calling

  • Initiate FaceTime audio/video calls programmatically
  • Real-time call event webhooks
  • WebSocket audio streaming
  • Voicemail drop with TTS
  • Per-line call concurrency controls

Webhooks + events

  • 29 event types: messages, calls, line health, workflows
  • HMAC-SHA256 signed payloads
  • Automatic retries with exponential backoff
  • Per-message status callbacks (sent → delivered → read)
  • Delivery dashboard with replay

Power features

  • Bulk send (100 messages per request)
  • Scheduled sends (up to 30 days)
  • Multi-line fan-out (load balance + warming)
  • Group chats (create, manage, message)
  • Workflows (visual builder for drip campaigns)
  • Idempotency keys to deduplicate retries
  • Auto SMS fallback for non-iPhone recipients

Browse by topic

QuickstartAuthenticationSandboxSDKs & librariesMessages APIWebhooksPhone numbersIdempotencyNumber lookup

Base URL

All requests go to https://api.bluereplies.com/v1. The API is HTTPS-only. Sandbox and production share the same base URL — your API key prefix selects the mode.