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 part of typed content — usually type: "media" with an attachments array of public URLs.

Send media

curl -X POST https://api.blooio.com/v4/messages \
  -H "Authorization: Bearer bl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+15551234567",
    "content": {
      "type": "media",
      "text": "Here is the file",
      "attachments": [
        { "url": "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 "from": { "type": "blooio" }.
  • Caption text is optional on media content.