Docs
BetaThe V4 API is in beta — endpoints and functionality may change.

Attachments

Send images, videos, and files with v4 media content.

In v4, attachments are a top-level attachments array of public URLs; add text for an optional caption.

How a media send is fetched, prepared, and delivered. Click a step for details.

Send media

curl -X POST https://api.blooio.com/v4/messages \
 -H "Authorization: Bearer bl_live_..." \
 -H "Content-Type: application/json" \
 -d '{
 "to": "+15551234567",
 "text": "Here is the file",
 "attachments": ["https://cdn.example.com/invoice.pdf"]
 }'
Try it

URLs must be publicly reachable over HTTPS. Common formats include images (JPEG, PNG, GIF, HEIC), video, audio, and PDFs — exact support depends on the channel.

Tips

  • Prefer stable CDN URLs; ephemeral signed URLs can expire before the device downloads them.
  • Keep files reasonably sized for mobile delivery.
  • For iMessage-only media behavior, constrain with "channel_type": "blooio".
  • Caption text is optional alongside attachments.