AACFlow

Typeform

Interact with Typeform

Usage Instructions

Integrate Typeform into the workflow. Can retrieve responses, download files, and get form insights. Can be used in trigger mode to trigger a workflow when a form is submitted. Requires API Key.

Tools

typeform_responses

Input

ParameterTypeRequiredDescription
formIdstringYesTypeform form ID (e.g., "abc123XYZ")
apiKeystringYesNo description
pageSizenumberNoNo description
beforestringNoNo description
afterstringNoNo description
sincestringNoRetrieve responses submitted after this date (e.g., "2024-01-01T00:00:00Z")
untilstringNoRetrieve responses submitted before this date (e.g., "2024-12-31T23:59:59Z")
completedstringNoFilter by completion status (e.g., "true", "false", "all")

Output

ParameterTypeDescription
total_itemsnumberTotal number of responses
page_countnumberTotal number of pages available
itemsarrayArray of response objects with response_id, submitted_at, answers, and metadata

typeform_files

Input

ParameterTypeRequiredDescription
formIdstringYesTypeform form ID (e.g., "abc123XYZ")
responseIdstringYesResponse ID containing the files (e.g., "resp_xyz789")
fieldIdstringYesNo description
filenamestringYesNo description
inlinebooleanNoNo description
apiKeystringYesNo description

Output

ParameterTypeDescription
fileUrlstringDirect download URL for the uploaded file
filefileDownloaded file stored in execution files
contentTypestringMIME type of the uploaded file
filenamestringOriginal filename of the uploaded file

typeform_insights

Input

ParameterTypeRequiredDescription
formIdstringYesTypeform form ID (e.g., "abc123XYZ")
apiKeystringYesNo description

Output

ParameterTypeDescription
fieldsarrayNumber of users who dropped off at this field
dropoffsnumberNumber of users who dropped off at this field
idstringUnique field ID
labelstringField label
refstringField reference name
titlestringField title/question
typestringField type (e.g., short_text, multiple_choice)
viewsnumberNumber of times this field was viewed
formobjectAverage completion time for this platform
platformsarrayAverage completion time for this platform
average_timenumberAverage completion time for this platform
completion_ratenumberCompletion rate for this platform
platformstringPlatform name (e.g., desktop, mobile)
responses_countnumberNumber of responses from this platform
total_visitsnumberTotal visits from this platform
unique_visitsnumberUnique visits from this platform
summaryobjectOverall average completion time
average_timenumberOverall average completion time
completion_ratenumberOverall completion rate
responses_countnumberTotal number of responses
total_visitsnumberTotal number of visits
unique_visitsnumberTotal number of unique visits

typeform_list_forms

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
searchstringNoSearch query to filter forms by title (e.g., "Customer Feedback")
pagenumberNoNo description
pageSizenumberNoNo description
workspaceIdstringNoFilter forms by workspace ID (e.g., "ws_abc123")

Output

ParameterTypeDescription
total_itemsnumberTotal number of forms in the account
page_countnumberTotal number of pages available
itemsarrayArray of form objects with id, title, created_at, last_updated_at, settings, theme, and _links

typeform_get_form

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
formIdstringYesForm unique identifier (e.g., "abc123XYZ")

Output

ParameterTypeDescription
idstringForm unique identifier
titlestringForm title
typestringForm type (form, quiz, etc.)
settingsobjectForm settings including language, progress bar, etc.
themeobjectTheme reference
workspaceobjectWorkspace reference
fieldsarrayArray of form fields/questions
welcome_screensarrayArray of welcome screens (empty if none configured)
thankyou_screensarrayArray of thank you screens
created_atstringForm creation timestamp (ISO 8601 format)
last_updated_atstringForm last update timestamp (ISO 8601 format)
published_atstringForm publication timestamp (ISO 8601 format)
_linksobjectRelated resource links including public form URL

typeform_create_form

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
titlestringYesNo description
typestringNoForm type (default: "form"). Options: "form", "quiz"
workspaceIdstringNoWorkspace ID to create the form in (e.g., "ws_abc123")
fieldsjsonNoArray of field objects defining the form structure. Each field needs: type, title, and optional properties/validations
settingsjsonNoNo description
themeIdstringNoNo description

Output

ParameterTypeDescription
idstringCreated form unique identifier
titlestringtitle output from the tool
typestringForm type
settingsobjectForm settings object
themeobjectTheme reference
workspaceobjectWorkspace reference
fieldsarrayArray of created form fields (empty if none added)
welcome_screensarrayArray of welcome screens (empty if none configured)
thankyou_screensarrayArray of thank you screens
_linksobjectRelated resource links including public form URL

typeform_update_form

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
formIdstringYesForm unique identifier to update (e.g., "abc123XYZ")
operationsjsonYesArray of JSON Patch operations (RFC 6902). Each operation needs: op (add/remove/replace), path, and value (for add/replace)

Output

ParameterTypeDescription
messagestringSuccess confirmation message

typeform_delete_form

Input

ParameterTypeRequiredDescription
apiKeystringYesNo description
formIdstringYesForm unique identifier to delete (e.g., "abc123XYZ")

Output

ParameterTypeDescription
deletedbooleanWhether the form was successfully deleted
messagestringDeletion confirmation message

On this page

Start building today
Trusted by over 100,000 builders.
The SaaS platform to build AI agents and run your agentic workforce.
Get started