Actions25
Overview
This node integrates with the EspoCRM API to manage CRM data. Specifically, for the Contact - Create operation, it allows users to create a new contact record in EspoCRM by providing details such as the contact's name, email, phone number, address, and other relevant fields.
Common scenarios where this node is beneficial include:
- Automating the addition of new contacts collected from web forms or lead generation tools directly into EspoCRM.
- Synchronizing contacts from other systems or databases into EspoCRM without manual entry.
- Enriching CRM data by programmatically adding detailed contact information.
For example, after capturing a lead on a website, you can use this node to automatically create a contact in EspoCRM with their first name, last name, email, phone number, and address.
Properties
| Name | Meaning |
|---|---|
| First Name | The contact's first name (optional). |
| Last Name | The contact's last name (required). |
| Additional Fields | A collection of optional additional contact details: |
| - Email Address | Primary email address of the contact. |
| - Phone Number | Contact's phone number. |
| - Title | Job title of the contact. |
| - Account ID | Identifier of the associated account in EspoCRM. |
| - Description | Text description or notes about the contact. |
| - Address | Structured address details including: |
| Street | Street address line. |
| City | City name. |
| State | State or province. |
| Country | Country name. |
| Postal Code | Postal or ZIP code. |
Output
The node outputs an array of JSON objects representing the created contact records. Each object contains the properties of the newly created contact as returned by the EspoCRM API, typically including identifiers, timestamps, and all submitted fields.
If the node supports binary data output (not indicated here), it would summarize any binary content related to the contact, but for this operation, output is purely JSON.
Dependencies
- Requires an active connection to an EspoCRM instance via an API key or authentication token configured in n8n credentials.
- The node uses the EspoCRM REST API endpoints to perform operations.
- No additional external services are required beyond EspoCRM itself.
Troubleshooting
- Missing Required Fields: If the "Last Name" field is not provided, the node will throw an error because it is mandatory.
- Authentication Errors: Ensure that the API credentials for EspoCRM are correctly set up and have sufficient permissions to create contacts.
- API Request Failures: Network issues or incorrect EspoCRM URLs can cause request failures. Verify connectivity and endpoint correctness.
- Invalid Field Values: Providing improperly formatted data (e.g., invalid email format) may result in API validation errors.
- Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error messages in the output.
Links and References
- EspoCRM API Documentation
- n8n Documentation on Expressions (useful for dynamic parameter values)