Actions28
Overview
This node integrates with the Dolibarr API to manage contacts, specifically allowing users to add categories to a contact. It is useful in scenarios where you want to organize or classify contacts by assigning them to one or more categories within Dolibarr, such as grouping customers by type, region, or any custom classification.
For example, if you have a contact representing a client and want to tag them as "VIP" or "Wholesale," this node operation lets you add those category tags programmatically.
Properties
| Name | Meaning |
|---|---|
| Contact ID | The unique identifier of the contact to which you want to add categories. Must be a positive integer. |
| Category ID | The unique identifier of the category to add to the specified contact. Must be a positive integer. |
Output
The node outputs the full HTTP response from the Dolibarr API after attempting to add the category to the contact. This includes status information and any returned data in JSON format. The main output field json will contain the API's response body, typically confirming success or detailing errors.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to a Dolibarr instance via its REST API.
- Needs an API authentication credential configured in n8n (an API key or token) to authorize requests.
- The base URL of the Dolibarr API must be set in the credentials configuration.
Troubleshooting
Common issues:
- Invalid or missing Contact ID or Category ID will cause the API call to fail.
- Incorrect API credentials or base URL will result in authentication errors.
- Trying to add a category that does not exist or is not accessible may return a 404 or similar error.
Error messages:
- Authentication errors usually indicate invalid or expired API keys; verify and update credentials.
- 404 Not Found errors suggest the contact or category ID does not exist; double-check IDs.
- Validation errors from the API may occur if IDs are not positive integers or required parameters are missing.