Overview
This node integrates with the SmartSuite API to create new records within a specified table of a SmartSuite solution. It is designed for users who want to automate data entry or integrate SmartSuite record creation into their workflows. For example, you could use this node to automatically add new customer information collected from a web form into your SmartSuite database, or to log support tickets created in another system.
The "Create Record" operation allows setting multiple field values for the new record, including special handling for date range fields like due dates.
Properties
| Name | Meaning |
|---|---|
| Solution | Select the SmartSuite Solution where the record will be created. |
| Table | Select the specific Table within the chosen Solution where the record will be added. |
| Field Values | Specify one or more fields and their corresponding values to set on the new record. |
- Field Values: For each field, you select the field name and provide the value to assign. Special handling exists for
start_dateanddue_datefields, which are combined into a date range object internally.
Output
The node outputs JSON data representing the result of the create operation:
success: Boolean indicating if the operation was successful.data: The newly created record's data as returned by the SmartSuite API.operation: The string"create"indicating the performed operation.resource: The string"record"indicating the resource type.solutionId: The ID of the SmartSuite solution used.tableId: The ID of the table where the record was created.
If multiple records were created (not typical for this operation), each would be output separately.
Dependencies
- Requires an active connection to the SmartSuite API via an API key credential configured in n8n.
- The node depends on the SmartSuite API endpoints for solutions, tables, and records.
- The user must have appropriate permissions in SmartSuite to create records in the selected solution and table.
Troubleshooting
- Missing or invalid Solution/Table selection: Ensure that the Solution and Table are correctly selected and accessible. The node loads options dynamically; if these fail to load, check API connectivity and credentials.
- Invalid field names or values: The field names must match those in the selected table. Using incorrect field slugs or unsupported value formats may cause errors.
- Date fields handling: For date range fields like due_date, ensure to provide
start_dateand/ordue_datevalues properly. Incorrect formatting can lead to API errors. - API errors: If the API returns errors, verify that the API key has sufficient permissions and that the SmartSuite service is operational.
- Continue On Fail: If enabled, the node will continue processing subsequent items even if some fail, returning error details in the output.
Links and References
- SmartSuite API Documentation (general reference for API endpoints and data structures)
- n8n Documentation - Creating Custom Nodes (for understanding node development concepts)
This summary is based solely on static analysis of the provided source code and property definitions.