Clients

Create a client

Add a new client to your database.

If taxId is provided and another client in your workspace already has the same taxId (normalized: case-insensitive, ignoring separators like dots and hyphens), the request is rejected with 409 CLIENT_TAXID_EXISTS and the existing client's id is returned in existingClientId.

post/v1/clients

Request

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

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 created

idstring

Unique identifier

createdAtstring date-time

updatedAtstring date-time