NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Jotform connects to a Nagent workspace with an API key. Once it is connected, agents can call 18 Jotform actions, such as "Create Label", "Get Label" and "Get Label Resources". 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 Jotform, with input parameters and output schema.
JOTFORM_CLONE_FORMTool to clone a single form in Jotform. Creates a complete copy of the form with all its questions and settings. Use when you need to duplicate an existing form.
Input parameters
Form ID to clone. This is the unique identifier of the form you want to duplicate.
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
JOTFORM_CREATE_LABELTool to create a new label for organizing forms in Jotform. Use when you need to categorize or group forms with a named label.
Input parameters
Name of the label to create. This is a required field.
Color code for the label in hexadecimal format (e.g., #F09E39, #FF5733). If not provided, a default color will be assigned by the system.
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
JOTFORM_DELETE_LABELTool to delete a label along with all its sublabels. Use when you need to remove a label from the account.
Input parameters
Label ID 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
JOTFORM_GET_LABELTool to retrieve details of a label by its ID, including name and color. Use when you need to fetch information about a specific label.
Input parameters
Label ID to retrieve details 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
JOTFORM_GET_LABEL_RESOURCESTool to get a list of assets (forms) in a label and their associated information. Use when you need to retrieve forms organized under a specific label.
Input parameters
Label ID to retrieve resources 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
JOTFORM_GET_SYSTEM_PLANTool to retrieve details of a specific system plan. Use when you need to check limits and pricing of a plan.
Input parameters
Name of the system plan to retrieve.
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
JOTFORM_GET_USER_DETAILSTool to retrieve details of the authenticated user, including account and usage info. Use after confirming valid API key.
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
JOTFORM_GET_USER_FOLDERSTool to retrieve a list of labels (folders replacement) for the authenticated user. Uses the GET /user/labels endpoint per Jotform's migration from folders to labels.
Input parameters
Owner username or workspace/team ID. Conditionally required for some accounts/workspaces.
Include label resources (e.g., forms) in the response when true (addResources=1).
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
JOTFORM_GET_USER_FORMSTool to retrieve a list of forms created by the authenticated user. Use after setting up API key authentication.
Input parameters
Number of forms to return
Filter by folder ID
Offset for pagination
Search query
Order by field
Sorting direction: 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
JOTFORM_GET_USER_HISTORYTool to fetch user activity history records. Use when auditing or filtering user actions by type or date.
Input parameters
Predefined date range to limit history
Filter history by action type (e.g., userCreation, formUpdate, apiKeyCreated, userLogout)
Sort order of results
End date (MM/DD/YYYY) to filter history
Start date (MM/DD/YYYY) to filter history
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
JOTFORM_GET_USER_REPORTSTool to retrieve list of report URLs for all forms in the account. Includes Excel, CSV, printable charts, and embeddable HTML tables.
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
JOTFORM_GET_USER_SETTINGSTool to retrieve the settings of the authenticated user. Use after confirming a valid API key.
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
JOTFORM_GET_USER_SETTINGS_BY_KEYTool to retrieve a specific user setting by key. Use when you need a single setting value like email, timezone, language, or website.
Input parameters
The specific user setting key to retrieve. Common keys include: email, timezone, language, website
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
JOTFORM_GET_USER_SUBMISSIONSTool to retrieve all submissions for all forms on the account. The answers dictionary contains submission data with question IDs as keys. Use when you need to access submission data across multiple forms.
Input parameters
Number of results in each result set for submission data. Default is 20. Maximum is 1000.
Filters the query results to fetch a specific submissions range. Provide as JSON string, example: '{"new":"1"}' to filter only new submissions.
Start of each result set for submission data. Useful for pagination. Default is 0.
Order results by a submission field name: id, form_id, IP, created_at, status, new, flag, updated_at.
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
JOTFORM_GET_USER_USAGETool to retrieve monthly usage statistics for the authenticated user. Use to check form submissions, payment forms, SSL submissions, and storage used.
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
JOTFORM_REMOVE_LABEL_RESOURCESTool to remove specified resources (forms) from a label by their IDs and types. Use when you need to unassign forms from a specific label.
Input parameters
The unique identifier of the label from which resources will be removed
List of resources (forms) to remove from the label. Each resource must specify an 'id' and 'type'
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
JOTFORM_UPDATE_LABELTool to update an existing label with new name or color settings. Use when you need to modify label properties.
Input parameters
Label ID to update
New name for the label
New color for the label in hex format (e.g., #FF5733)
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
JOTFORM_UPDATE_USER_SETTINGSTool to update user's settings like time zone, language, email, and website. Use when you need to modify user account settings.
Input parameters
Full name of the user
New email address for the user
Company name of the user
New website URL for the user
Industry sector of the user
Preferred language code for the user (e.g., 'en', 'es', 'fr')
IANA time zone identifier for the user (e.g., 'America/New_York', 'Europe/London')
Answer to the security question
Security question for account recovery
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 18 Jotform actions on Nagent, including "Create Label", "Get Label" and "Get Label Resources". Create Label: Create a new label for organizing forms in Jotform. Each action is listed on this page with its input parameters and its output.
Jotform 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 Label takes 1 required input: name. It also takes 1 optional input: color. It returns data, error and successful.