Public Contacts Patch

Request

Partial update of a contact.

Only fields present in the payload are applied. Reassigning the parent is not supported — delete the contact and POST a new one.

Path

contact_idinteger, >= 1(Contact Id)required

Mercura contact id

authorizationstring or null(Authorization)

Bearer <mrc_live_…> API key

Bodyapplication/jsonrequired

namestring or null, <= 500 characters(Name)

emailstring or null, (email)(Email)

phonestring or null, <= 100 characters(Phone)

Example:"+49 211 5551099"

external_idstring or null, [ 1 .. 255 ] characters(External Id)^[A-Za-z0-9._\-:]{1,255}$

is_activeboolean or null(Is Active)

is_defaultboolean or null(Is Default)

Example:true

curl -i -X PATCH \
  'https://docs.mercura.ai/_mock/openapi/contacts/{contact_id}' \
  -H 'Content-Type: application/json' \
  -H 'authorization: string' \
  -d '{
    "is_default": true,
    "phone": "+49 211 5551099"
  }'

Responses

Successful Response

Bodyapplication/json

idinteger(Id)required

Example:5567

parent_typestring(ContactParentType)required

Which kind of business partner a contact is attached to.

Enum:"customer""supplier"

Example:"customer"

parent_idstring or null(Parent Id)

Parent's partner-supplied id (customer_id for customers, supplier_id for suppliers)

Example:"K-10042"

external_idstring or null(External Id)

Example:"ASP-00815"

namestring or null(Name)

Example:"Thomas Weber"

emailstring or null(Email)

Example:"t.weber@mustermann-elektro.example"

phonestring or null(Phone)

Example:"+49 211 5551020"

is_activeboolean(Is Active)required

Example:true

is_defaultboolean(Is Default)required

Example:true

created_atstring, (date-time)(Created At)required

Example:"2026-02-03T10:16:00Z"

updated_atstring, (date-time)(Updated At)required

Example:"2026-07-05T11:03:00Z"

Response

{
  "created_at": "2026-02-03T10:16:00Z",
  "email": "t.weber@mustermann-elektro.example",
  "external_id": "ASP-00815",
  "id": 5567,
  "is_active": true,
  "is_default": true,
  "name": "Thomas Weber",
  "parent_id": "K-10042",
  "parent_type": "customer",
  "phone": "+49 211 5551020",
  "updated_at": "2026-07-05T11:03:00Z"
}