POST
/
v1
/
api
/
messages
Send a single text or attachment message
curl --request POST \
  --url https://backend.blooio.com/v1/api/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "to": "+15551234567"
}'
{
  "message_id": "Qm8FhbH3P7R",
  "status": "queued"
}

Authorizations

​
Authorization
string
header
required

API key must be provided in the Authorization header as Bearer YOUR_API_KEY.

Headers

​
Idempotency-Key
string

Optional key to ensure idempotent message creation. If the same key is used twice, the original message will be returned.

Body

application/json
​
to
string
required

Recipient phone number in E.164 format (e.g., +15551234567)

Example:

"+15551234567"

​
text
string

Text body of the message.

Example:

"Hello world!"

​
attachments
string<uri>[]

Array of publicly accessible URLs to media attachments.

Example:
["https://example.com/image.png"]
​
metadata
object

Arbitrary key/value pairs to associate with the message.

Response

Message already exists (idempotency key match).

​
message_id
string
Example:

"Qm8FhbH3P7R"

​
status
string
Example:

"queued"