API Introduction

Send and manage messages via simple HTTP endpoints. All endpoints are under /v2/api and use Bearer auth.

Overview

The Blooio Messaging API lets you send and receive messages over iMessage, RCS, and SMS. The API automatically selects the most elevated messaging method supported by the target device - iMessage for Apple devices, RCS for supported Android devices, and SMS as a universal fallback. All endpoints are prefixed with /v2/api and secured with a Bearer API key.

Send messages

Send messages to any chat (phone, email, or group) with attachments and idempotency.

Track delivery

Fetch message status or full details.

Webhooks

Receive inbound messages and delivery/read events.

Manage webhooks

Create, update, and delete webhooks.

Account

Validate your key and view devices and usage.

Contacts

Manage contacts with names, tags, and capabilities.

Groups

Create and manage group chats with members and icons.

Reactions

Add tapback reactions to any message.

What's New in v2

Chat-centric API - Messages organized by chat (phone number, email, or group ID)
Contacts management - Full CRUD for contacts with names and capabilities
Groups - Create groups, manage members, set icons
Reactions - Add/remove iMessage tapback reactions
RESTful webhooks - Proper resource-based URLs with webhook IDs

Authentication

Include your API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Base URL:

https://backend.blooio.com/v2/api