Overview
This node integrates with the SmartSuite API to manage tables within a SmartSuite solution. Specifically, the Table - Create operation allows users to create a new table in a selected SmartSuite solution by specifying its name, label, description, icon, and primary field name.
Common scenarios where this node is beneficial include:
- Automating the setup of new data structures (tables) in SmartSuite as part of onboarding or project initialization workflows.
- Dynamically creating tables based on external inputs or triggers without manual intervention.
- Integrating SmartSuite table creation into larger automation pipelines that provision resources and configure environments.
For example, a user could automate the creation of a project management table with a custom label and icon whenever a new client is onboarded, ensuring consistent structure across solutions.
Properties
| Name | Meaning |
|---|---|
| Solution | Select the SmartSuite solution where the new table will be created. |
| Table Name | The internal name identifier for the new table. |
| Table Label | The display label for the new table shown in the SmartSuite UI. |
| Table Description | Optional description providing details about the purpose or contents of the table. |
| Icon | The icon name representing the table visually; defaults to "table" if not specified. |
| Primary Field Name | The name of the primary field for the table, defaulting to "Title" if not provided. |
Output
The node outputs JSON data describing the result of the table creation operation. The output structure includes:
success: Boolean indicating whether the operation succeeded.data: The full response object from the SmartSuite API representing the newly created table.operation: The operation performed, here always"create".resource: The resource type, here"table".solutionId: The ID of the SmartSuite solution where the table was created.
Example output JSON snippet:
{
"success": true,
"data": {
"id": "new_table_id",
"name": "MyTable",
"label": "My Table",
"description": "A description",
"icon": "table",
"primary_field": {
"name": "Title"
},
...
},
"operation": "create",
"resource": "table",
"solutionId": "selected_solution_id"
}
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the SmartSuite API via an API key credential configured in n8n.
- The node depends on the SmartSuite API endpoint
/applications/to create tables. - The user must have appropriate permissions in SmartSuite to create tables within the selected solution.
Troubleshooting
- Missing or invalid Solution ID: Ensure the selected solution exists and the ID is correct. Use the "Solution" dropdown to select a valid solution.
- API authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- Invalid or missing required fields: The "Table Name" and "Table Label" are mandatory. Make sure these are provided and non-empty.
- Unexpected API errors: Check the error message returned by the API for details. Network issues or rate limits may cause failures.
- Icon name issues: If using a custom icon name, ensure it is supported by SmartSuite or omit to use the default.
If the node throws errors, enabling detailed logging or inspecting the raw API response can help diagnose the problem.