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

Link previews

Send URL balloons and override iMessage link preview image and title.

When text is exactly one URL on a Blooio channel, Blooio can deliver it as an iMessage URL balloon (hero image, title, link). Previews use Open Graph metadata by default; override them with link_preview.

Auto preview

curl -X POST https://api.blooio.com/v4/messages \
 -H "Authorization: Bearer bl_live_..." \
 -H "Content-Type: application/json" \
 -d '{
 "channel_type": "blooio",
 "to": "+15551234567",
 "text": "https://example.com/launch"
 }'
Try it

Override image and title

{
 "channel_type": "blooio",
 "to": "+15551234567",
 "text": "https://example.com/launch",
 "link_preview": {
 "image_url": "https://cdn.example.com/og.jpg",
 "title": "Launch day"
 }
}

Tips

  • Prefer "channel_type": "blooio" — rich previews are an iMessage feature.
  • text should be exactly the URL (no surrounding copy) for the balloon path.
  • See Message content for the other content fields, including rich_link where supported.