SmartSuite icon

SmartSuite

Interact with SmartSuite API

Actions21

Table → Create Table Field

AI-generated

Overview

This node operation creates a new field in a specified table within a selected solution in SmartSuite. It is useful for dynamically modifying the structure of tables by adding fields of various types such as text, number, date, single select, multiple select, and more. Practical examples include adding a new 'Due Date' field to a project management table or a 'Rating' field to a customer feedback table.

Use Case Examples

  1. Add a 'Phone' field to a contacts table to store phone numbers.
  2. Create a 'Status' field in a task table to track task progress.

Properties

Name Meaning
Solution Select the SmartSuite solution where the table resides. This is required to scope the table selection and field creation.
Table Select the specific table within the chosen solution where the new field will be created. This is required to identify the target table.
Field Name The name of the new field to be created in the table. This is a required string input.
Field Type The type of the new field, determining the kind of data it will hold. Options include text, number, date, single select, multiple select, and many specialized field types.
Help Text Optional help text to describe or provide guidance about the new field.

Output

JSON

  • fieldId - The unique identifier of the newly created field.
  • fieldName - The name of the newly created field.
  • fieldType - The type of the newly created field.
  • helpText - The help text associated with the newly created field, if any.

Dependencies

  • SmartSuite API with valid API key credentials

Troubleshooting

  • Ensure the selected solution and table IDs are valid and accessible with the provided API credentials.
  • Field names must be unique within a table; attempting to create a field with a duplicate name may result in an error.
  • The field type must be one of the supported types; invalid types will cause the operation to fail.
  • API rate limits or connectivity issues may cause request failures; verify network and API status.

Links

Discussion