Contact Cardv2

Share contact card

POST/chats/{chatId}/contact-card

Stage the contact card (Name & Photo) for sharing in a chat. The contact card will be piggybacked onto the next outgoing message (text or attachment) sent to this chat. This is idempotent — calling it multiple times is harmless.

⚠️ Plan requirement: Contact card sharing is only available on Dedicated Commercial and Dedicated Enterprise plans. Numbers on other plans receive a 403.

Path parameters

chatIdRequiredstring

Chat identifier. Can be: (1) phone number in E.164 format (e.g., +15551234567), (2) email address, (3) group ID (grp_xxxx), or (4) comma-separated list of phone numbers/emails for multi-recipient group chats (e.g., +15551234567,+15559876543). All values should be URL-encoded.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Returns

successoptionalboolean

chat_idoptionalstring

Normalized chat identifier

messageoptionalstring

Response codes

200Contact card staged for sharing

401Authentication required or invalid

502Temporary communication error

503No active number available

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X POST https://api.blooio.com/v2/api/chats/chat_a1b2c3d4/contact-card \  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "success": true,  "chat_id": "chat_a1b2c3d4",  "message": "Contact card staged. It will be sent with the next outgoing message in this chat."}