Docs

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.