TextBubbles API

A unified REST API for sending iMessages with automatic SMS fallback. Built for businesses who want to reach customers on their preferred messaging platform.

Features

• iMessage delivery with automatic SMS fallback
• Customer isolation — each customer gets full data segregation
• Delivery confirmations and read receipts
• Reply threading — respond to specific messages
• Unsend & edit — retract or update sent messages
• Tapback reactions — send and receive emoji reactions with structured webhook data
• Image carousels — send up to 20 images as a gallery
• Message effects — fireworks, confetti, balloons, and more
• Scheduled messages — queue messages for future delivery
• Webhooks — real-time delivery updates, inbound messages, and wildcard event subscriptions

Quick Example

curl -X POST https://api.textbubbles.com/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155551234",
    "content": { "text": "Hello from TextBubbles!" }
  }'

{
  "success": true,
  "data": {
    "id": "msg_550e8400-e29b-41d4-a716-446655440000",
    "status": "queued",
    "to": "+14155551234",
    "createdAt": "2026-03-28T10:00:00.000Z"
  }
}

Developer Experience

• Simple REST API with consistent JSON responses
• Customer-scoped Bearer token authentication with bcrypt-hashed API keys
• Idempotency key support for safe retries
• Rate limiting with Retry-After headers
• Customer-scoped webhooks with wildcard event subscriptions
• 99.9% uptime target
• HTTPS everywhere

Machine-Readable Documentation

Building with an AI coding agent? These plain-text files contain the complete API documentation in a single fetch:

• /llms.txt — Concise overview with endpoint summary
• /llms-full.txt — Complete API documentation (all endpoints, schemas, code examples)