Dolibarr icon

Dolibarr

Interact with Dolibarr API

Contact → Add Categories

AI-generated

Overview

This node operation adds one or more categories to a specified contact in Dolibarr. It is useful for organizing contacts by categorizing them, which can help in filtering, reporting, or managing contacts based on their assigned categories. For example, a user can add a 'VIP' category to important clients or a 'Supplier' category to vendor contacts.

Use Case Examples

  1. Add a 'VIP' category to a contact with ID 123 to mark them as a high-priority client.
  2. Assign multiple categories to a contact to classify them under different segments for targeted communication.

Properties

Name Meaning
Contact ID The unique identifier of the contact to which categories will be added. This is a required numeric field with a minimum value of 1.
Category ID The unique identifier of the category to add to the contact. This is a required numeric field with a minimum value of 1. It is used in the request URL to specify which category to add.
Request Options Additional settings for the request such as batching, SSL certificate validation, proxy configuration, and timeout settings.

Output

JSON

  • contactID - The ID of the contact to which categories were added.
  • categoryID - The ID of the category that was added to the contact.
  • statusCode - HTTP status code returned by the Dolibarr API indicating the result of the add category operation.
  • responseBody - The full response body from the Dolibarr API after attempting to add the category to the contact.

Dependencies

  • Dolibarr API with valid credentials

Troubleshooting

  • Ensure the Contact ID and Category ID are valid and exist in Dolibarr to avoid 404 errors.
  • Check network connectivity and proxy settings if requests fail to reach the Dolibarr API.
  • If SSL certificate validation fails, consider enabling the 'Ignore SSL Issues' option, but be aware of security risks.
  • Timeout errors can occur if the server is slow to respond; adjust the timeout setting accordingly.

Discussion