Skip to main content
PATCH
/
api
/
contacts
/
{id}
Update Contact
curl --request PATCH \
  --url https://qwoty.app/api/contacts/{id} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "email": "<string>",
  "phone": {},
  "role": [
    {}
  ],
  "id_crm": {},
  "id_erp": {},
  "id_accounting": {}
}
'
{
  "success": true,
  "data": {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "customer_id": "550e8400-e29b-41d4-a716-446655440000",
    "first_name": "Jean",
    "last_name": "Dupont",
    "email": "jean.dupont@acme.com",
    "phone": "+33 6 99 88 77 66",
    "role": ["buyer", "billing"],
    "id_crm": null,
    "id_erp": null,
    "id_accounting": null,
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-03-24T14:00:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer qwoty_your_token

​
Path Parameters

​
id
string
required
UUID of the contact to update

​
Request Body

All fields are optional. Only the fields provided will be updated.
​
first_name
string
Contact’s first name
​
last_name
string
Contact’s last name
​
email
string
Email address
​
phone
string | null
Phone number. Set to null to unset.
​
role
array
Assigned roles. Allowed values: "buyer", "signer", "billing", "shipping", "legal", "admin"
​
id_crm
string | null
External CRM ID
​
id_erp
string | null
External ERP ID
​
id_accounting
string | null
External accounting ID
customer_id cannot be changed after creation.

​
Examples

curl -X PATCH https://qwoty.app/api/contacts/660e8400-e29b-41d4-a716-446655440001 \
  -H "Authorization: Bearer qwoty_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+33 6 99 88 77 66",
    "role": ["buyer", "billing"]
  }'

​
Response

​
success
boolean
true if the update succeeded
​
data
object
The updated contact object (same shape as Get Contact)
{
  "success": true,
  "data": {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "customer_id": "550e8400-e29b-41d4-a716-446655440000",
    "first_name": "Jean",
    "last_name": "Dupont",
    "email": "jean.dupont@acme.com",
    "phone": "+33 6 99 88 77 66",
    "role": ["buyer", "billing"],
    "id_crm": null,
    "id_erp": null,
    "id_accounting": null,
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-03-24T14:00:00Z"
  }
}