Actions25
Overview
This node integrates with EspoCRM's API to perform operations on dynamic entities within the CRM system. Specifically, for the "Dynamic" resource and the "Create" operation, it allows users to create new records of any entity type defined in EspoCRM by specifying the entity type and a set of fields with their values.
Common scenarios where this node is beneficial include:
- Automating the creation of custom or standard CRM records without hardcoding entity types.
- Integrating external systems that generate data needing to be stored dynamically in EspoCRM.
- Building flexible workflows that handle multiple entity types based on runtime parameters.
For example, you could use this node to create a new "Opportunity" record by selecting "Opportunity" as the entity type and providing field values such as "name", "amount", and "closeDate".
Properties
| Name | Meaning |
|---|---|
| Entity Type Name or ID | The type of entity to create a record for (e.g., Opportunity, Case, Product). Choose from a dynamically loaded list of entity types or specify an ID using an expression. |
| Fields | A collection of fields to set on the new record. Each entry requires: - Field Name or ID: Select from dynamically loaded fields for the chosen entity type or specify an ID via expression. - Field Value: The value to assign to the field. |
Output
The node outputs an array of JSON objects representing the created records. Each object corresponds to one created record and contains the properties returned by the EspoCRM API for that record, typically including the record's unique identifier and all fields set or defaulted by the system.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to an EspoCRM instance via an API key credential configured in n8n.
- The node depends on EspoCRM's REST API being accessible and properly configured to accept requests for the specified entity types.
- Dynamic loading of entity types and fields relies on metadata services provided by EspoCRM.
Troubleshooting
- Error loading entity types or fields: This can occur if the API credentials are invalid or the EspoCRM instance is unreachable. Verify API credentials and network connectivity.
- Invalid field names or values: Ensure that the field names correspond exactly to those defined in the EspoCRM entity metadata. Using expressions incorrectly may cause errors.
- Operation not supported error: If an unsupported operation or resource is selected, the node will throw an error. Confirm that "Dynamic" resource and "Create" operation are selected.
- API request failures: Check EspoCRM API limits, permissions, and that the entity type supports creation.
Links and References
- EspoCRM API Documentation
- n8n Expressions Documentation (for using expressions in property values)