EspoCRM CRUD

Perform CRUD operations in EspoCRM
Join our community

Actions4

Overview

The EspoCRM CRUD node enables users to perform Create, Read, Update, and Delete operations on entities within an EspoCRM system via its REST API. This node is useful for automating data management tasks such as adding new contacts, retrieving account details, updating records, or deleting obsolete entries in EspoCRM.

Typical use cases include:

  • Creating new CRM records automatically from form submissions.
  • Fetching existing entity data for reporting or processing.
  • Updating customer information based on external triggers.
  • Removing outdated or incorrect records programmatically.

For example, you could use this node to delete a Contact record by specifying the entity type as "Contact" and providing the record ID of the contact to be deleted.

Properties

Name Meaning
Operation The CRUD operation to perform: Create, Read, Update, or Delete.
Entity Type The type of entity to operate on, e.g., Contact, Account.
Record ID The unique identifier of the record for Read, Update, or Delete operations.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output item contains the response data returned from the EspoCRM API for the respective operation.

  • For Create and Update, the output JSON includes the newly created or updated record data.
  • For Read, it returns the requested record's data.
  • For Delete, it returns the API response confirming deletion.
  • In case of errors (if "Continue On Fail" is enabled), the output JSON will contain an error field with the error message.

The node does not output binary data.

Dependencies

  • Requires an active EspoCRM instance accessible via its REST API.
  • Needs an API key credential for authentication with EspoCRM.
  • Uses HTTP requests with JSON payloads to communicate with the EspoCRM API.
  • No additional environment variables are required beyond the configured credentials.

Troubleshooting

  • No credentials returned!
    This error occurs if the node cannot find valid API credentials. Ensure that the API key credential is properly configured in n8n.

  • Unknown operation error
    If an unsupported operation is specified, the node throws an error indicating the operation is unknown. Verify that the operation property is set to one of: Create, Read, Update, or Delete.

  • HTTP request failures
    Network issues, invalid URLs, or incorrect API keys can cause request errors. Check the EspoCRM URL and API key correctness. Also, verify network connectivity to the EspoCRM server.

  • Missing Record ID for Read/Update/Delete
    These operations require a valid record ID. Omitting it will likely cause API errors. Make sure to provide the correct record ID when performing these operations.

Links and References

Discussion