Clients

Partial update a client

Update only the provided fields on an existing client. Returns 409 CLIENT_TAXID_EXISTS if the new taxId is already in use by another client in your workspace.

patch/v1/clients/{clientId}

Request

Base URL: https://api.frihet.io
URL: https://api.frihet.io/v1/clients/{clientId}
Auth: API key in header X-API-Key

Path parameters

clientIdstring required

Client unique identifier

Request body

namestring required

Client name (person or company)

emailstring email

Contact email

phonestring

Phone number

taxIdstring

Tax identification number (NIF/CIF/VAT)

integrationSource'hubspot' | 'pipedrive' | 'intercom' | 'mailchimp'

Source integration when the client is imported from an external CRM or marketing tool.

Example request

{
  "name": "Acme Corp",
  "email": "billing@acme.com",
  "phone": "+34 912 345 678",
  "taxId": "B12345678",
  "address": {
    "street": "Calle Gran Via 28",
    "city": "Madrid",
    "province": "Madrid",
    "zip": "28013",
    "country": "ES"
  },
  "nextAction": {
    "title": "Call to validate the accepted quote",
    "dueDate": "2026-07-10"
  }
}

Response

Client updated

idstring

Unique identifier

createdAtstring date-time

updatedAtstring date-time