PlumoAI icon

PlumoAI

Consume PlumoAI API

Actions4

Record → Add Record

AI-generated

Summary

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).

Discussion