add_result
Add Form Result
Adds a new result entry (submission) to a form programmatically. Field keys must match the exact field identifiers defined in the Formdesk form builder. Supports file uploads via base64-encoded values.
add_result
Adds a new result entry (submission) to a form programmatically. Field keys must match the exact field identifiers defined in the Formdesk form builder. Supports file uploads via base64-encoded values.
authenticate_visitor
Validates a visitor's credentials (username and password) and returns the authenticated visitor's data if successful. Useful for verifying visitor identity before granting access.
get_result_pdf
Generates and retrieves a PDF document from a form result entry. Supports configurable paper size, orientation, scaling, margins, and optional password protection. Returns the PDF as base64-encoded data.
update_visitor
Updates an existing visitor's information including name, email, username, and password. Only the provided fields are updated.
export_results
Exports form results to a file in various formats: Excel, CSV, XML, dBase, FoxPro, or plain text. Returns the file content as base64-encoded data. Supports the same date and status filters as the result listing tool.
mark_result_processed
Marks a form result entry as "processed" to track synchronization state. This enables incremental sync workflows where you can later query only unprocessed results to avoid reprocessing.
remove_visitor
Removes a visitor account from Formdesk.
add_visitor
Creates a new visitor account. Visitors are registered users who can log in to forms that support entry maintenance. A password is auto-generated if not provided.
get_file
Retrieves an uploaded file associated with a form submission by its file name or ID. Returns the file content as base64-encoded data along with its MIME type.
get_result_details
Retrieves the full details of a specific form submission result, including all submitted field data and system metadata. Optionally includes file attachment information.
sign_on
Signs on a user or form visitor without requiring them to enter credentials, enabling SSO integration from external systems. Returns a redirect URL with a session token that grants access to Formdesk.
remove_result
Removes a form result entry. Can either delete the entire result or only remove uploaded files associated with it while keeping the submission data intact.
get_visitor_results
Retrieves all form results associated with a specific visitor across one or more forms. Useful for viewing a visitor's complete submission history.
get_form_results
Retrieves a list of form submission result IDs for a given form. Supports extensive filtering by date ranges (created, changed, completed), status, sync status, visitor, and pre-defined filters. Use the returned result IDs with the **Get Result Details** tool to fetch full submission data.
list_forms
Retrieves all forms available in the Formdesk account. Returns form identifiers and names that can be used with other tools to query submissions, export data, or manage results.
get_form_filters
Retrieves the list of pre-defined filters (views) configured on a form. These filters can be used with the **Get Form Results** tool to narrow down result queries.
list_visitors
Retrieves all form visitors (registered users who can log in to forms supporting entry maintenance). Optionally filter by a search query.
update_result
Updates an existing form result entry with new field data. Only the fields provided will be updated; other fields remain unchanged.
park_data
Pushes data to Formdesk temporarily and returns a ticket. When the ticket is used to open a form, the form fields are pre-filled with the parked data. Useful for pre-populating forms from external systems.
Manage online forms, submissions, and visitors on Formdesk. Retrieve form lists, query and filter form results by date, status, or sync state, and export submissions to Excel, CSV, XML, or PDF. Add, update, and remove form result entries programmatically, including file uploads. Manage form visitors (list, add, update, remove, authenticate) and retrieve visitor-associated results. Pre-fill forms using data parking with ticketed URLs. Mark results as processed for incremental sync workflows. Supports single sign-on for users and visitors, and retrieves uploaded files and pre-defined filters.
Common questions about connecting Formdesk to AI agents with Metorial.