Blooio API Reference
One HTTP API for iMessage, SMS, RCS, and WhatsApp. Send and receive messages, manage contacts and chats, run polls and groups, and subscribe to a unified event feed.
Quickstart
Send your first message in minutes.
Authentication
Authenticate with your API key.
Webhooks
Receive events in real time.
API Reference
Every endpoint, generated from the spec.
Send a message
curl -X POST https://api.blooio.com/v2/api/chats/%2B15551234567/messages \
-H "Authorization: Bearer bl_live_..." \
-H "Content-Type: application/json" \
-d '{ "text": "Hello from Blooio!" }'curl -X POST https://api.blooio.com/v4/messages \
-H "Authorization: Bearer bl_live_..." \
-H "Content-Type: application/json" \
-d '{
"channel_id": "ch_...",
"to": { "identifier": "+15551234567" },
"content": { "type": "text", "text": "Hello from Blooio!" }
}'Explore the reference
Account
1Authentication and account information
Numbers
2Manage phone numbers linked to your account
Contact Card
3Manage and share your iMessage contact card (Name & Photo)
Contacts
9Manage contacts (phone numbers and emails)
Groups
7Manage contact groups
Group Members
3Manage group membership
Webhooks
6Manage webhook subscriptions
Webhook Logs
2View and replay webhook deliveries
Chats
5View conversations and messages
Messages
4View individual messages and their status
Typing Indicators
2Control typing indicators for conversations
Read Receipts
1Mark conversations as read
Reactions
1Add or remove reactions to messages. Supports classic iMessage tapbacks (love, like, dislike, laugh, emphasize, question) and emoji reactions (e.g. +😂, -😂).
Polls
2Send native iMessage polls and retrieve poll results with vote counts. Poll events are delivered via separate webhook event types (poll.received, poll.created, poll.voted) and require webhook_type 'poll' or 'all'.
Location
3FindMy contact location tracking
FaceTime
1Initiate FaceTime calls
Phone Numbers
3Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan (Dedicated Enterprise).
Account
6Authenticated account, sender numbers, and contact cards.
Location
4Find My friend locations (device passthrough).
Channels
4Sending surfaces (iMessage/Blooio, Twilio, WhatsApp, RCS) and their capabilities.
Contacts
13Contacts, their channel identities, capabilities, timeline, and tags.
Chats
14Conversations and chat-level actions (typing, read, contact card, background).
Messages
13Send messages and read message history, status, events, and reactions.
Polls
3Native iMessage polls (Blooio channels).
Groups
8Group chats on group-capable channels (Blooio, WhatsApp).
Webhooks
8Webhook subscriptions and delivery attempts for inbound + lifecycle events.
Events
2Unified activity feed across messages, polls, groups, reactions, and typing.
Phone Numbers
3Phone number lookup and geocoding (enterprise plans).