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 | null

Base64 image or data URI (data:image/png;base64,...). null removes the photo; lines that cannot clear a photo show a plain black image instead.

sharingoptionalobject
enabledoptionalboolean
audienceoptionalinteger

0 = Contacts Only, 1 = Always Ask

01
name_formatoptionalinteger

0 = First & Last, 1 = First Only

01

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 \
Body object
Response objectexample
{  "data": {}}