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

Update a number's contact card

PUT/me/numbers/{number}/contact-card

Updates the contact card (name, avatar, sharing settings) shared from this number. At least one field is required.

Path parameters

numberRequiredstring

Sender phone number in E.164 format, e.g. +15551234567.

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

Body parameters

JSON
first_nameoptionalstring
last_nameoptionalstring
avataroptionalstring

Public image URL or data URI.

sharingoptionalobject
enabledoptionalboolean
audienceoptionalstring
name_formatoptionalstring

Returns

dataoptionalobject

Response codes

200Updated contact card
401Your API key is missing or invalid. Pass it as a bearer token.
422Validation failed — one or more fields in the request are invalid or missing.

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

Request
curl -X PUT https://api.blooio.com/v4/me/numbers/%2B15551234567/contact-card \  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "first_name": "Jane",    "last_name": "Doe",    "avatar": "https://example.com/image.jpg",    "sharing": {      "enabled": true,      "audience": "string",      "name_format": "2025-01-15T09:30:00Z"    }  }'
Body object
Response objectexample
{  "data": {}}