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 content.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 '{
    "from": { "type": "blooio" },
    "to": "+15551234567",
    "content": { "type": "text", "text": "https://example.com/launch" }
  }'
Try it

Override image and title

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

Tips

  • Prefer "from": { "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 broader content union, including rich_link where supported.