NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Fillout Forms connects to a Nagent workspace with an API key. Once it is connected, agents can call 22 Fillout Forms actions, such as "Create Database", "Create Database Webhook" and "Create field". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Fillout Forms, with input parameters and output schema.
FILLOUT_FORMS_AUTHORIZE_O_AUTHTool to initiate the OAuth authorization process for third-party applications. Use when you need to generate the URL to redirect your users to the Fillout consent page.
Input parameters
An arbitrary string to maintain state between the request and callback. It will be returned to your redirect URI.
The client ID of your OAuth application in Fillout, found in Developer settings.
The URL to which users will be redirected after granting or denying authorization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_CREATE_DATABASETool to create a new Zite database instance with tables and fields. Use when you need to create a structured database in Fillout with custom tables and field definitions. Each database must have at least one table, and each table must have at least one field.
Input parameters
The name of the database to create.
Array of table definitions to create in the database. Each table must have a name and at least one field. At least one table is required.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_CREATE_DATABASE_WEBHOOKTool to create a webhook subscription for a Fillout database. The webhook will receive HTTP POST notifications when subscribed events occur (e.g., record.created, record.updated, record.deleted). Use when you need to set up real-time notifications for database changes. Maximum 100 webhooks per database.
Input parameters
The destination URL that will receive HTTP POST requests when subscribed events occur. Must be a valid HTTPS URL.
Array of event types to subscribe to. At least one event must be specified. Common events include record.created, record.updated, and record.deleted.
Optional: Filter webhook notifications to events from a specific table only. If omitted, the webhook will receive events from all tables in the database.
Unique identifier of the database to create the webhook for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_CREATE_FIELDTool to add a new field to an existing table with specified type, name, and configuration. Use when you need to extend a database table with additional columns.
Input parameters
Field name
Field type (e.g., single_select, single_line_text, date, number, checkbox, email, url, phone, multi_select, long_text, attachment, formula, lookup, rollup, created_time, last_modified_time, created_by, last_modified_by, autonumber, barcode, button, count, currency, duration, last_modified_by, percent, rating, relation)
Table identifier (accepts either ID or table name)
Field-specific configuration options. For single_select or multi_select types, this should contain an 'options' array with objects having 'label' and 'color' properties. For other field types, this may contain type-specific configuration.
The database's unique identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_CREATE_RECORDTool to create a new record in a Fillout table with the provided field data. Use when you need to add a new entry to a specific table in your Fillout database. The record parameter should be a dictionary where keys are field names (or field IDs) from your table schema, and values are the data to store in those fields.
Input parameters
Record data with field names or field IDs as keys and their corresponding values. The keys should match the field names or IDs in your table schema. Values can be strings, numbers, booleans, or null.
Unique identifier of the table (or table name) where the record will be created.
Unique database identifier. This is the ID of the database containing the table where you want to create a record.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_CREATE_TABLETool to add a new table with custom schema to an existing database. Use when you need to create a structured table in a Fillout database with specific field definitions. Each table must have at least one field.
Input parameters
The name of the table to create.
Array of field definitions for this table. Each table must have at least one field. Each field requires a type, name, and template object.
The unique identifier of the database where the table will be created.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_DELETE_DATABASETool to permanently delete a database and all its data including tables, fields, views, and records. Use when you need to completely remove a database. Warning: This action cannot be undone.
Input parameters
The unique identifier of the database to permanently delete. Warning: This operation cannot be undone and will delete all data including tables, fields, views, and records.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_DELETE_DATABASE_WEBHOOKTool to remove a webhook subscription from a Fillout database. Use when you need to delete an existing webhook from a specific database.
Input parameters
Webhook identifier to delete
Unique database identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_DELETE_FIELDTool to permanently delete a field from a table. Use when you need to remove a field from a Fillout database table. Note: Cannot delete the primary field.
Input parameters
Field ID or name to delete. Cannot delete the primary field.
Table ID or name.
Unique database identifier.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_DELETE_RECORDTool to permanently delete a record from a table in Fillout Database. Use when you need to remove a specific record. This action cannot be undone.
Input parameters
Unique table identifier (or table name)
Record identifier (UUID)
Unique database identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_DELETE_TABLETool to permanently delete a table and all its data including fields, views, and records from a Fillout database. Use when you need to remove a table. This action cannot be undone.
Input parameters
The table identifier to delete. Accepts either the table ID or table name.
The unique identifier of the database containing the table to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_GET_DATABASE_BY_IDTool to retrieve detailed information about a specific database including all tables, fields, and views. Use when you need to get comprehensive database structure and metadata by database ID.
Input parameters
The unique identifier of the database
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_GET_DATABASESTool to retrieve a list of all databases for your organization. Use when you need to list available databases after authenticating with Fillout.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_GET_FORMSTool to retrieve a list of all forms in your account. Use when you need to list your forms after authenticating with Fillout.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_GET_RECORD_BY_IDTool to retrieve a single record by its UUID with all field data. Use when you need to fetch detailed information for a specific record from a Fillout table.
Input parameters
Table ID or name
Record's unique identifier (UUID)
Unique database identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_INVALIDATE_ACCESS_TOKENRevokes an OAuth access token obtained from Fillout's OAuth authorization flow. Use this action when a user logs out, disconnects their account, or when you need to programmatically revoke a third-party app's access to Fillout data. Important notes: - This action is for OAuth tokens only, NOT for API keys - OAuth tokens are obtained via the OAuth flow (authorize -> token exchange) - The operation is idempotent: invalidating an already-invalidated token succeeds - After invalidation, the token can no longer be used for API requests Example: A user disconnects your app from Fillout - call this to revoke their access token.
Input parameters
The OAuth access token to revoke. Must be a valid token obtained from Fillout's OAuth flow (not an API key). Do not include the 'Bearer' prefix - just the raw token value.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_LIST_DATABASE_WEBHOOKSTool to retrieve all webhook subscriptions configured for a specific database. Use when you need to list, audit, or manage existing webhooks for a database.
Input parameters
Unique identifier for the database. This is the database ID for which you want to retrieve all configured webhook subscriptions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_LIST_RECORDSTool to retrieve records from a Fillout table with filtering, sorting, and pagination. Supports complex filter conditions using AND/OR logic and 14 operators (equals, contains, greater_than, in, is_empty, etc.). Use when you need to query table data with specific conditions or retrieve paginated results.
Input parameters
Sort criteria with field ID and direction. Records are sorted by creation time ascending if omitted.
Number of records to return per page (default: 500, max: 2000)
Query conditions with AND/OR logic. Structure: {"and": \[{"field": "Status", "operator": "equals", "value": "Active"}\]} or {"or": \[...\]}. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty, in, not_in, greater_than, greater_than_or_equal_to, less_than, less_than_or_equal_to. Supports nested AND/OR groups.
Number of records to skip for pagination (default: 0)
Unique identifier or name of the table to retrieve records from
Unique identifier of the database containing the table
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_REMOVE_FORM_WEBHOOKTool to remove a webhook by its ID. Use when you need to delete an existing webhook from your Fillout account.
Input parameters
The ID of the webhook you received when you created it
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_UPDATE_FIELDTool to modify field properties and configuration for an existing field in a Fillout database table. Use when you need to update field names or change field configuration settings.
Input parameters
New field name to update the field with.
Field ID or name to update.
Table ID or name where the field exists.
Updated field configuration object containing field settings and properties. The structure varies by field type.
Unique database identifier where the table is located.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_UPDATE_RECORDTool to update specific fields of an existing record in a Fillout table. Use when you need to modify particular fields without affecting other fields in the record. Only the fields specified in the request will be updated.
Input parameters
Field key-value pairs to update. Keys are field names, values can be strings, numbers, booleans, or null depending on the field definition in your table.
Table identifier (ID or name)
Record identifier (UUID)
Database identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILLOUT_FORMS_UPDATE_TABLETool to update table properties like name. Use when you need to modify table metadata such as renaming a table in a Fillout database.
Input parameters
New table name to update. Only provided fields will be updated.
Unique identifier of the table. You can also use the table name instead of the ID.
Unique identifier of the database containing the table.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 22 Fillout Forms actions on Nagent, including "Create Database", "Create Database Webhook" and "Create field". Create Database: Create a new Zite database instance with tables and fields. Each action is listed on this page with its input parameters and its output.
Fillout Forms connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create Database takes 2 required inputs: name and tables. It returns data, error and successful.