Skip to main content
POST
Send outbound blue bubbles to Apple devices via active conversation sessions or direct phone numbers, and retrieve chronological message logs.

Body Parameters

string
Active conversation session ID (e.g. conv_01J8ABC123XYZ). Required if to is not provided.
string
Recipient phone number in E.164 format (e.g. +15551234567). Required if conversation_id is not provided.
string
required
The message text body to transmit.
string
Optional URL to a media attachment (PNG, JPEG, GIF, PDF) delivered inline with the message.
string
Optional agent identity ID or handle initiating the message.

Response Fields

string
Unique message identifier (e.g. imsg_01J8DEF456GHI).
string
The associated conversation session ID.
string
Message direction: outbound.
string
Delivery state: sent, queued, or failed.
string
ISO 8601 transmission timestamp.

Listing Conversation Messages

Retrieve chronological message history for an active or archived conversation: