Dolibarr icon

Dolibarr

Interact with Dolibarr API
Join our community

Actions28

Overview

This node allows you to create a new Contact in Dolibarr, an open-source ERP and CRM system. It is useful for automating the addition of contact records into your Dolibarr database directly from workflows, saving time and reducing manual data entry errors.

Common scenarios include:

  • Automatically adding new customer contacts collected from web forms or other systems.
  • Syncing contacts from external CRMs or databases into Dolibarr.
  • Creating contacts as part of onboarding processes or sales pipelines.

For example, when a new lead is captured via a marketing platform, this node can create a corresponding contact in Dolibarr with detailed information such as name, email, phone numbers, address, and custom extra fields.

Properties

Name Meaning
Last Name The last name or label of the contact (required).
First Name The first name of the contact.
Third-Party Name or ID The associated third-party (company) by selecting from a list, providing a URL containing the third-party ID, or entering the ID directly.
Civility Name or ID The civility code (e.g., Mr, Mrs) selected from a list or specified by ID.
Job Position The job position or role of the contact.
Email The contact's email address.
Address A collection of address details including: Address, Zip Code, City, Country (selectable from list or by ID), and State/Province (selectable from list or by ID).
Phones Number A collection of phone numbers including Business, Mobile, Personal, and Fax.
Private Boolean flag indicating if the contact is private (true) or not (false).
Personal A collection for personal details including Date of Birth and Birthday Alert (boolean to enable birthday notifications).
Extra Fields Multiple custom attribute fields that can be added dynamically. Each attribute consists of a field name (loaded from Dolibarr extra fields) and a corresponding value.
Fields Other contract-related fields (generic assignment collection, usage depends on context).

Output

The node outputs JSON data representing the newly created contact record as returned by the Dolibarr API. This typically includes the contact's unique ID and all submitted properties confirmed by the server.

No binary data output is produced by this node.

Dependencies

  • Requires an active Dolibarr API connection configured with a valid base URL and API authentication token.
  • The node uses Dolibarr REST API endpoints to perform operations.
  • Some property options are dynamically loaded from Dolibarr dictionaries (civilities, countries, states, extra fields).
  • Proper permissions in Dolibarr are required to create contacts.

Troubleshooting

  • Invalid URL or Missing socid: When specifying a third-party by URL, ensure the URL matches the expected pattern and contains a valid socid parameter. Otherwise, the node will reject it.
  • Missing Required Fields: The "Last Name" field is mandatory; omitting it will cause the request to fail.
  • API Authentication Errors: Ensure the API key/token and base URL credentials are correctly set up in n8n.
  • 404 Not Found Errors: May occur if referenced third-party or other linked entities do not exist.
  • Extra Fields Loading Issues: If extra fields do not load, verify API permissions and that the resource type supports extra fields.

Links and References

Discussion