Frihet icon

Frihet

AI-native ERP — invoices, expenses, clients, products, quotes, and vendors

Actions33

Client → Create

AI-generated

Summary

Create a new client in Frihet ERP

Inputs

  • clientName (required) — Name of the client (company or individual)
  • clientAdditional — Collection of additional client fields, placeholder "Add Field"
  • email — Client email address (used for sending invoices)
  • phone — Client phone number
  • taxId — Tax identification number (NIF, VAT, EIN, etc.)
  • website — Client website URL
  • fiscalZone — Determines tax regime applied to invoices for this client
  • clientType — Client type: company or individual
  • stage — CRM stage of the client
  • applyEquivalenceSurcharge — Whether to apply recargo de equivalencia (Spain retailers)
  • address — Structured address: { street, city, zip, province, country, countryCode }

Output shape

a single created client record

Returns the created client object including its generated ID and all fields; errors are wrapped in an error envelope from the API

Examples

Example 1: Create a company client with basic contact info

clientName: 'Acme Corp'; email: 'admin@acme.com'; fiscalZone: 'peninsula'; clientType: 'company'; stage: 'active'

Example 2: Create an individual client with address and tax ID

clientName: 'John Doe'; taxId: '12345678Z'; address: '{"street":"123 Main St","city":"Madrid","zip":"28001","province":"Madrid","country":"Spain","countryCode":"ES"}'

Example 3: Create a client with additional optional fields

clientName: 'Global Ltd'; website: 'https://global.example.com'; applyEquivalenceSurcharge: true; fiscalZone: 'eu'

Links

Discussion