NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Formsite connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 Formsite actions, such as "Get Form Details", "Get Form Items" and "Get Form Results". 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 Formsite, with input parameters and output schema.
FORMSITE_GET_FORMThis tool retrieves detailed information about a specific form in Formsite. It provides comprehensive details including the form's internal description, directory identifier, name, publishing information (embed code and form link), current state (e.g., "open"), and statistics (file size and number of results). **Important**: If the connection's base_url doesn't include the user directory, you must provide the 'user_dir' parameter. Find this in your Formsite form URLs (e.g., if URL is https://fs8.formsite.com/user123/forms/abc, user_dir is 'user123') or in Settings -> Integrations -> Formsite API.
Input parameters
The form's directory identifier (also called form ID). This can be found in your form's URL after '/forms/' (e.g., in 'https://fs8.formsite.com/abc123/forms/xyz789', the form_dir is 'xyz789').
The user directory for your Formsite account. If not provided, it will be extracted from the base_url. You can find this in your form URLs (e.g., if your form URL contains '/vSkOfz/forms/', your user_dir is 'vSkOfz') or in Settings -> Integrations -> Formsite API.
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
FORMSITE_GET_FORM_ITEMSRetrieves all items (questions) for a specific form using the Formsite API. This action returns detailed information about each form item including: - Item ID (unique identifier for the form question) - Position (sequential order in the form) - Label (the question text) - Children (optional, for Matrix and Multi Scale items with sub-items) The item data can be used to label results data by matching item IDs from this action to item IDs from the Get Form Results action. **Important**: If the connection's base_url doesn't include the user directory, you must provide the 'user_dir' parameter. Find this in your Formsite form URLs (e.g., if URL is https://fs8.formsite.com/user123/forms/abc, user_dir is 'user123') or in Settings -> Integrations -> Formsite API.
Input parameters
The form's directory/ID to retrieve items from
The user directory for your Formsite account. If not provided, it will be extracted from the base_url. You can find this in your form URLs (e.g., if your form URL contains '/vSkOfz/forms/', your user_dir is 'vSkOfz') or in Settings -> Integrations -> Formsite API.
Optional. Results Labels ID to apply for item labels
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
FORMSITE_GET_FORM_RESULTSThis tool retrieves form results from a specified FormSite form. It uses the GET https://{server}.formsite.com/api/v2/{user_dir}/forms/{form_id}/results endpoint to fetch results, handling required parameters such as form_id, user_dir, limit, page, and sort direction. **Important**: If the connection's base_url doesn't include the user directory, you must provide the 'user_dir' parameter. Find this in your Formsite form URLs (e.g., if URL is https://fs8.formsite.com/user123/forms/abc, user_dir is 'user123') or in Settings -> Integrations -> Formsite API.
Input parameters
Page number if results exceed limit
Maximum number of results to get (1-500, API max is 500)
The form directory/ID to fetch results from
The user directory for your Formsite account. If not provided, it will be extracted from the base_url. You can find this in your form URLs (e.g., if your form URL contains '/vSkOfz/forms/', your user_dir is 'vSkOfz') or in Settings -> Integrations -> Formsite API.
Sort direction for results (asc or desc)
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
FORMSITE_GET_WEBHOOKSRetrieves all webhooks configured for a specific form in FormSite. This action returns webhook configurations including URL, event type (e.g., 'result_completed'), and optional handshake_key for security. Webhooks notify external URLs when form events occur. **Important**: If the connection's base_url doesn't include the user directory, you must provide the 'user_dir' parameter. Find this in your Formsite form URLs (e.g., if URL is https://fs8.formsite.com/user123/forms/abc, user_dir is 'user123') or in Settings -> Integrations -> Formsite API.
Input parameters
The form directory/ID to fetch webhooks from
The user directory for your Formsite account. If not provided, it will be extracted from the base_url. You can find this in your form URLs (e.g., if your form URL contains '/vSkOfz/forms/', your user_dir is 'vSkOfz') or in Settings -> Integrations -> Formsite API.
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
FORMSITE_LIST_ALL_FORMSRetrieves a list of all forms in the user's Formsite account. This action returns detailed information about each form including: - Form directory (identifier for accessing the form via API) - Form name (the display name of the form) - Description (optional internal description) - Publish information (embed code and public link) - State (open/closed status) - Statistics (file storage size and results count) The form directory returned by this action can be used with other Formsite actions like Get Form Details, Get Form Items, and Get Form Results. **Important**: If the connection's base_url doesn't include the user directory, you must provide the 'user_dir' parameter. Find this in your Formsite form URLs (e.g., if URL is https://fs8.formsite.com/user123/forms/abc, user_dir is 'user123') or in Settings -> Integrations -> Formsite API.
Input parameters
The user directory for your Formsite account. If not provided, it will be extracted from the base_url. You can find this in your form URLs (e.g., if your form URL contains '/vSkOfz/forms/', your user_dir is 'vSkOfz') or in Settings -> Integrations -> Formsite API.
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 5 Formsite actions on Nagent, including "Get Form Details", "Get Form Items" and "Get Form Results". Get Form Details: This tool retrieves detailed information about a specific form in Formsite. Each action is listed on this page with its input parameters and its output.
Formsite 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.
Get Form Details takes 1 required input: form_dir. It also takes 1 optional input: user_dir. It returns data, error and successful.