Dolibarr icon

Dolibarr

Interact with Dolibarr API

Actions28

Contact → Create

AI-generated

Overview

This node operation creates a new contact in the Dolibarr system. It is useful for automating the addition of contact records with detailed information such as names, third-party association, civility, job position, email, address, phone numbers, personal details, and extra custom fields. For example, it can be used to add a new client contact with all relevant details directly from an automated workflow.

Use Case Examples

  1. Creating a new contact with first name, last name, and email for a sales lead.
  2. Adding a contact linked to a specific third-party company with address and phone details.
  3. Automating the creation of contacts with custom extra fields for specialized data tracking.

Properties

Name Meaning
Last Name Last Name or label of the contact, required for creation.
First Name First Name of the contact.
Third-Party Name or ID Associates the contact with a third-party entity by selecting from a list, providing a URL, or specifying an ID.
Civility Name or ID Civility code of the contact, selectable from a list loaded dynamically.
Job Position Job position or title of the contact.
Email Email address of the contact.
Address Collection of address-related fields including address, zip code, city, country, and state/province.
Phones Number Collection of phone numbers including business, mobile, personal, and fax.
Private Boolean flag indicating if the contact is private (1) or not (0).
Personal Collection of personal details including date of birth and birthday alert flag.
Extra Fields Multiple custom attribute fields with name and value pairs for additional data.
Fields Other contract fields that can be assigned dynamically.
Request Options Settings for batching, SSL validation, proxy, and timeout for the API request.

Output

JSON

  • id - The unique identifier of the created contact.
  • lastname - Last name of the created contact.
  • firstname - First name of the created contact.
  • email - Email address of the created contact.
  • socid - ID of the associated third-party entity.
  • civility_code - Civility code of the contact.
  • poste - Job position of the contact.
  • address - Street address of the contact.
  • zipcode - Postal code of the contact.
  • town - City or town of the contact.
  • country_id - Country ID of the contact.
  • state_id - State or province ID of the contact.
  • phone_pro - Business phone number.
  • phone_mobile - Mobile phone number.
  • phone_perso - Personal phone number.
  • fax - Fax phone number.
  • priv - Privacy flag of the contact (1 for private, 0 for not).
  • birthday - Date of birth of the contact.
  • birthday_alert - Flag indicating if birthday alert is enabled (1 or 0).
  • extraFields - Custom extra fields with their values.

Dependencies

  • Dolibarr API with authentication credentials

Troubleshooting

  • Ensure the required 'Last Name' field is provided; missing it will cause validation errors.
  • Verify the third-party ID or URL format if associating the contact with a third-party; invalid input will cause errors.
  • Check API credentials and base URL configuration to avoid authentication or connection failures.
  • If using custom extra fields, ensure the field names exist in Dolibarr setup to prevent request errors.

Links

Discussion