Overview
This node allows users to perform various operations on any module within SinergiaCRM via its SuiteCRM API (version 8). It supports creating, reading, updating, deleting records, and fetching relationships dynamically for the selected module. This flexibility makes it ideal for automating CRM workflows such as adding new contacts, updating account information, retrieving lists of leads, or managing related entities.
For example, you can use this node to:
- Create a new record in a custom module by providing JSON data.
- Retrieve all records from the "Contacts" module with pagination support.
- Update an existing record by specifying its ID and updated fields.
- Delete a record by ID.
- Fetch related records linked to a specific entity.
Properties
| Name | Meaning |
|---|---|
| Module | Selects the target module in SinergiaCRM where the operation will be performed. |
| Data (JSON) | JSON object containing the fields and values to create or update a record. |
Note: The "Data (JSON)" property is required for the "create" and "update" operations and expects valid JSON representing the record attributes.
Output
The node outputs an array of items, each containing a json field with the response data from SinergiaCRM:
- For Create operation: The output JSON contains the newly created record's data as returned by the API.
- For other operations (not requested here), the structure varies accordingly (e.g., fetched records, confirmation of deletion).
No binary data output is produced by this node.
Example output JSON for a create operation might look like:
{
"id": "12345",
"type": "ModuleName",
"attributes": {
"field1": "value1",
"field2": "value2"
}
}
Dependencies
- Requires an API authentication token credential configured in n8n to connect to SinergiaCRM.
- The node uses the SinergiaCRM SuiteCRM API v8 endpoint, constructed from the domain URL provided in credentials.
- No additional external dependencies are needed beyond the API access.
Troubleshooting
- Invalid JSON in Data property: If the JSON input for the "Data (JSON)" property is malformed, the node will fail. Ensure the JSON syntax is correct.
- Authentication errors: If the API credentials are incorrect or expired, requests will fail. Verify the API key/token and domain URL.
- Module not found: Selecting a module that does not exist or is misspelled will cause errors. Use the module dropdown which loads available modules dynamically.
- API rate limits or connectivity issues: Network problems or API limits may cause request failures. Check network connectivity and API usage quotas.
- Error messages from API: The node surfaces error messages from SinergiaCRM API responses. Review these messages to adjust request parameters or data.
If "Continue On Fail" is enabled, the node will continue processing subsequent items even if some fail, returning error details in the output.