Blooio API Reference

Authentication and account information

Manage phone numbers linked to your account

Manage and share your iMessage contact card (Name & Photo)

Manage contacts (phone numbers and emails)

Manage contact groups

Manage group membership

Manage webhook subscriptions

View and replay webhook deliveries

View conversations and messages

View individual messages and their status

Control typing indicators for conversations

Mark conversations as read

Add or remove reactions to messages. Supports classic iMessage tapbacks (love, like, dislike, laugh, emphasize, question) and emoji reactions (e.g. +😂, -😂).

Send 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'.

FindMy contact location tracking

Initiate FaceTime calls

Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan (Dedicated Enterprise).

Deliverability and risk-tolerance reporting for your numbers. **Scope** — Reports are organization-scoped: any API key in the organization returns the whole organization's dedicated fleet, regardless of which numbers a particular key is attached to. **Eligibility** — Risk scoring is only available for dedicated numbers (Dedicated Commercial or Dedicated Enterprise); shared, trial, and inbound numbers return `403 dedicated_plan_required`. Dedicated numbers are the only lines whose per-number usage is meaningful to score. **What the score means** — Each number gets a `risk_score` from 0 (lowest risk) to 100 (highest), mapped to a `risk_level`: `low` (0-29, healthy), `medium` (30-59, monitor), `high` (60-100, likely to be filtered/suspended by carriers). The score is the clamped sum of ten additive risk factors (see `RiskFactors`); positive factor scores raise risk, negative scores (bonuses) lower it. High **inbound** volume and engagement lower risk; high **outbound** volume, bursts, low reply rates, and templated content raise it. **How it's computed** — Fully real-time: every request recomputes from Postgres over the requested window (there is no cache on the report endpoints). The metric fan-out is collapsed into a handful of org-wide `GROUP BY allocation_id` queries that run on a single database connection, so cost is roughly independent of fleet size. Conversation-initiation signals read the `channel_thread_stats` rollup (one row per conversation, holding its earliest message + direction); engagement, contacts, and bursts scan the windowed `messages`; message similarity derives a SimHash per outbound message at read time. **Window** — Defaults to the trailing 30 days; override with `days` or an explicit `from`/`to` epoch-ms range (see the per-endpoint query params).

Authenticated account, sender numbers, and contact cards.

Find My friend locations (device passthrough).

Sending surfaces (iMessage/Blooio, Twilio, WhatsApp, RCS) and their capabilities.

Channel routing / number pools: ordered sets of channels walked by priority for the agnostic send.

Contacts, their channel identities, capabilities, timeline, and tags.

Conversations and chat-level actions (typing, read, contact card, background).

Send messages and read message history, status, events, and reactions.

Native iMessage polls (Blooio channels).

Group chats on group-capable channels (Blooio, WhatsApp).

Webhook subscriptions and delivery attempts for inbound + lifecycle events.

Unified activity feed across messages, polls, groups, reactions, and typing.

Phone number lookup and geocoding (enterprise plans).