Actions4
- Table Actions
- Record Actions
Record → Add Record
AI-generatedSummary
Add a new record to a specified table within a selected project on PlumoAI, setting its status and populating its fields with provided data. Optionally upload an attachment file linked to the new record.
Inputs
- Authentication (required) — Select the authentication method for API access; currently supports API Token.
- Project Name or ID (required) — Choose the project by name or ID where the record will be added. Options are loaded dynamically from the API.
- Table Name or ID (required) — Select the table within the chosen project where the record should be added. Options are loaded dynamically and depend on the selected project.
- Status Name or ID (required) — Specify the workflow status for the new record. Options are dynamically loaded based on the selected project and table.
- Record Fields (required) — Define the values for the record's fields using a resource mapper that loads the available fields from the selected table.
- Attachment — Optionally specify the name of the binary property containing a file to upload and attach to the new record. Usually set to 'data' if the file comes from a previous node.
Output shape
a single JSON object representing the newly created record with detailed field values, including any uploaded attachments.
The operation returns the enriched record details as a single-item JSON array output. An error is thrown if record creation or retrieval of the detailed record fails.
Examples
Example 1: Create a new record with specific fields and status in a project table, then upload and attach a file from previous node binary data.
Select authentication as 'API Token', pick a project and table from dropdowns, select an applicable status, map required fields with their values, and set 'Attachment' to the binary property name (if uploading a file).