Docs

Contact cards

Manage Name & Photo for a Blooio number and share it into a chat.

A contact card is the Name & Photo identity recipients see for a Blooio number. Cards are per number. Sharing is a chat action on Blooio channels.

Contact card update and share features require a plan that includes Name & Photo. Other plans return 403.

List your numbers

curl https://api.blooio.com/v4/me/numbers \
  -H "Authorization: Bearer bl_live_..."
Try it

Read / update a card

curl https://api.blooio.com/v4/me/numbers/%2B15551230001/contact-card \
  -H "Authorization: Bearer bl_live_..."

curl -X PUT https://api.blooio.com/v4/me/numbers/%2B15551230001/contact-card \
  -H "Authorization: Bearer bl_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "first_name": "Ada", "last_name": "Lovelace" }'
Try it

Upload an avatar with POST .../contact-card/avatar (multipart, max 10MB).

Remove the photo by sending "avatar": null. The name stays as it is. Some lines can't clear a photo; those show a plain black image instead.

curl -X PUT https://api.blooio.com/v4/me/numbers/%2B15551230001/contact-card \
  -H "Authorization: Bearer bl_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "avatar": null }'
Try it

Share into a chat

curl -X POST https://api.blooio.com/v4/chats/chat_.../contact-card \
  -H "Authorization: Bearer bl_live_..."
Try it