Contactsv4

Update a contact

PATCH/contacts/{contactId}

Path parameters

contactIdRequiredstring

Unique identifier of the contact, prefixed with ct_. Returned when you create a contact or by the List contacts endpoint.

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

nameRequiredstring

Returns

dataoptionalContact

idoptionalstring

Contact id (ct_...).

nameoptionalstring | null

created_atoptionalinteger

tagsoptionalstring[]

last_message_timeoptionalinteger | null

last_directionoptionalstring | null

"inbound""outbound"null

last_textoptionalstring | null

last_statusoptionalstring | null

identitiesoptionalobject[]

Array of object

idoptionalstring

channel_typeoptionalstring

"blooio""twilio""whatsapp""whatsapp_business""rcs_business"

identifieroptionalstring

channel_idoptionalstring | null

created_atoptionalinteger

Response codes

200Updated contact

401Your API key is missing or invalid. Pass it as a bearer token.

404No contact was found with the provided `contactId`.

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 PATCH https://api.blooio.com/v4/contacts/ct_a1b2c3d4 \

  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "name": "Jane Doe"  }'

Body object

{  "name": "Jane Doe"}

Response objectexample

{  "data": {    "id": "ct_a1b2c3d4",    "name": "Jane Doe",    "created_at": 0,    "tags": [      "string"    ],    "last_message_time": 0,    "last_direction": "inbound",    "last_text": "string",    "last_status": "string",    "identities": [      {        "id": "obj_a1b2c3d4",        "channel_type": "blooio",        "identifier": "+15551234567",        "channel_id": "ch_a1b2c3d4",        "created_at": 0      }    ]  }}