Actions6
Overview
This node integrates with the Microsoft Dynamics 365 Dataverse API, enabling users to perform various operations on Dataverse entities. Specifically, the Create record operation allows users to add new records to a selected Dataverse entity by specifying values for one or more columns.
Common scenarios where this node is beneficial include:
- Automating data entry into Dataverse from other systems or workflows.
- Creating new customer, contact, or account records dynamically based on external triggers.
- Integrating Dataverse with other applications without manual data import/export.
For example, you could use this node to create a new contact record in Dataverse whenever a form is submitted on your website, mapping form fields to the corresponding Dataverse columns.
Properties
| Name | Meaning |
|---|---|
| Entity Name | Select the Dataverse entity (e.g., contacts, accounts) where the new record will be created. |
| Columns | Define one or more columns and their values to set on the new record. Each column has: |
| Column Name | The specific column within the selected entity to populate. |
| Column Value | The value to assign to the selected column for the new record. |
The Entity Name property is required and must be chosen from the list of available Dataverse entities. The Columns property supports multiple entries, allowing setting multiple fields on the new record.
Output
The node outputs JSON data representing the response from the Dataverse API after creating the record. This typically includes details of the newly created record such as its unique identifier and any other returned metadata.
The output structure is an array of items, each containing a json field with the API response for the corresponding input item.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token credential configured in n8n to authenticate with the Dataverse API.
- The node uses internal caching mechanisms to load and cache the list of entities and their columns for dropdown selections.
- Network access to the Microsoft Dataverse environment is necessary.
Troubleshooting
- Authentication errors: Ensure that the API authentication token credential is correctly configured and has sufficient permissions to create records in the target Dataverse environment.
- Invalid entity or column names: If the selected entity or columns do not exist or are misspelled, the node will fail. Use the dropdowns to select valid options.
- Missing required fields: Some Dataverse entities may require certain columns to be set when creating a record. Verify that all mandatory fields are provided.
- API rate limits or connectivity issues: Network problems or API throttling can cause failures. Retry or check network connectivity.
- Error messages: Errors thrown by the node include context about which input item caused the failure. Use this information to debug specific inputs.