NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Formcarry connects to a Nagent workspace with an API key. Once it is connected, agents can call 4 Formcarry actions, such as "Create Form", "Delete Form" and "Retrieve Form Submissions". 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 Formcarry, with input parameters and output schema.
FORMCARRY_CREATE_FORMCreate a new form with customizable settings including email notifications, webhooks, and thank you pages. This action creates a Formcarry form with extensive configuration options for email notifications (both to form owners and respondents), webhook integrations, Google Recaptcha spam protection, and customizable thank you pages. Use when you need to programmatically set up a new form with specific notification rules or integrations.
Input parameters
Name of the form. This is the identifier you'll use to recognize the form in your Formcarry dashboard.
Email addresses for self respondent notifications. Separate multiple addresses with comma (e.g., 'admin@example.com,support@example.com').
Failed page URL to redirect users after failed submission. Required if returnUrl is present.
Webhook URL. Formcarry will send a POST request to this URL when a new submission is received.
Save incoming submissions to formcarry database. Default is true. Set to false if you only want to forward submissions via webhook.
Thank you page URL to redirect users after successful submission. If provided, failUrl is also required.
Enable auto-response email notifications to be sent to form respondents. This sends a confirmation email to the person who submitted the form.
Enable sending form message in query string to Return URL. When enabled, form data will be passed as query parameters.
HTML email template code if selfEmail_theme is Custom. Supports Dynamic Tags for inserting submission data.
From email address for self email notifications sent to form owner.
Google Recaptcha secret key to enable Google Recaptcha spam protection on the form.
Email template theme options.
HTML code for Custom theme respondent auto-response email. Supports Dynamic Tags for personalization.
From email address for respondent auto-response notifications.
Subject line of self email notifications sent to form owner.
Display mode for the thank you page.
Email template theme options.
Theme options for the built-in thank you page.
Message content for Fancy or Formal theme respondent auto-response emails.
Subject line of respondent auto-response email notification.
Send email notifications for submissions marked as spam. Default is false. Enable only if you want to review spam submissions.
Message text displayed on the thank you page below the headline.
The headline text displayed at the top of the thank you page.
URL to redirect when user clicks the primary button on the thank you page.
Text displayed on the primary button of the thank you page. Defaults to 'Return' if not specified.
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
FORMCARRY_DELETE_FORMDelete an existing form by its Form ID. Use when you need to permanently remove a form from your Formcarry account.
Input parameters
The unique identifier of the form to delete. You can find this in your Formcarry dashboard or by listing forms via the 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
FORMCARRY_RETRIEVE_SUBMISSIONSRetrieves all submissions for a specific Formcarry form. Returns a paginated list of form submissions with their field data, timestamps, and submission IDs. Use pagination parameters to navigate through large submission sets. Default page size is 25, maximum is 50 submissions per page. Useful for: collecting form responses, exporting submission data, integrating form data into other systems, or building custom analytics dashboards.
Input parameters
Page number for pagination. Starts from 1.
Number of submissions per page. Default is 25, Max is 50.
The unique identifier of the form whose submissions you want to retrieve. You can find this in your Formcarry dashboard or by listing forms via the 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
FORMCARRY_VERIFY_AUTHTool to verify API key authentication with Formcarry. Use this endpoint to check if your API key is valid before making other API requests. Returns success status and a confirmation message if the API key is valid.
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 4 Formcarry actions on Nagent, including "Create Form", "Delete Form" and "Retrieve Form Submissions". Create Form: Create a new form with customizable settings including email notifications, webhooks, and thank you pages. Each action is listed on this page with its input parameters and its output.
Formcarry 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 Form takes 1 required input: name. It also takes 24 optional inputs: email, failUrl, webhook, retention, returnUrl, autoResponse, returnParams, selfEmail_code, selfEmail_from, googleRecaptcha, selfEmail_theme, autoResponse_code, autoResponse_from, selfEmail_subject, thankYouPage_mode, autoResponse_theme, thankYouPage_theme, autoResponse_message, autoResponse_subject, selfEmail_sendOnSpam, thankYouPage_message, thankYouPage_headline, thankYouPage_returnUrl and thankYouPage_returnText. It returns data, error and successful.