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

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 PATCH 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" }'

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

Share into a chat

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