Fillout Forms

List forms and retrieve submissions from Fillout.

On this page

Connect
Call it from a workflow
Actions (4)
findFormByTitle
getFormResponses
getSingleResponse
custom_api_call
Details

Connect

Auth type: API key (secret_text). Paste the API key (or token) from the provider's settings into the connect dialog. It is encrypted at rest and only decrypted on the server when an action runs.

In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
For every project in a workspace: Workspace settings, Integrations.
Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.

Call it from a workflow

Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.

Native workflow

// .workflow.js (native ctx)
export async function run(ctx) {
  const res = await ctx.integrations.invoke("fillout-forms", "findFormByTitle", {
    "title": "<form title>"
  });
  if (!res.success) throw new Error(res.error);
  ctx.log.info("Fillout Forms answered", { output: res.output });
}

defineWorkflow module

// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";

export default defineWorkflow({
  id: "fillout-forms-findformbytitle",
  name: "Fillout Forms: Find Form by Title",
  description: "Calls Fillout Forms when a row is created.",
  trigger: { type: "entity_event", entity: "tickets", event: "created" },
  async run(ctx, event) {
    const res = await ctx.integrations.call("fillout-forms", {
      "action": "findFormByTitle",
      "title": "<form title>"
    }) as { success: boolean; error?: string };
    if (!res.success) throw new Error(res.error);
  },
});

From an app (connector proxy)

curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/fillout-forms/findFormByTitle" \
  -H "Authorization: Bearer $APP_KEY" \
  -H "content-type: application/json" \
  -d '{"props":{"title":"<form title>"}}'

Actions

findFormByTitlein catalog

Find Form by Title. Finds an existing forms by title.

Input	Type	Description
`title`required	text	The (partial or full) title of the form to search for.

getFormResponsesin catalog

Get Form Responses. Fetch all responses for a Fillout form, with optional filters.

Input	Type	Description
`formId`required	id (picked from your account)	Form
`limit`optional	number	Max number of submissions to retrieve (1-150).
`afterDate`optional	date-time (ISO)	Filter submissions after this date (YYYY-MM-DDTHH:mm:ss.sssZ).
`beforeDate`optional	date-time (ISO)	Filter submissions before this date (YYYY-MM-DDTHH:mm:ss.sssZ).
`offset`optional	number	Starting position for fetching submissions.
`status`optional	one of "in_progress"	By default, only finished submissions are returned. Select "In Progress" to get unfinished submissions instead.
`includeEditLink`optional	boolean	Include a link to edit the submission.
`includePreview`optional	boolean	Include preview responses.
`sort`optional	one of "asc" \| "desc"	Sort order.
`search`optional	text	Filter for submissions containing this text.

getSingleResponsein catalog

Get Single Response. Retrieves a specific submission from a form.

Input	Type	Description
`formId`required	id (picked from your account)	Form
`submissionId`required	id (picked from your account)	Select from the 50 most recent submissions for the chosen form.
`includeEditLink`optional	boolean	Include a link to edit the submission.

custom_api_call

Custom API Call. Make a custom API call to a specific endpoint

Input	Type	Description
`url`required	object (depends on other props)	url
`method`required	one of "GET" \| "POST" \| "PATCH" \| "PUT" \| "DELETE" \| "HEAD"	Method
`headers`required	object	Authorization headers are injected automatically from your connection.
`queryParams`required	object	Query Parameters
`body_type`optional	one of "none" \| "json" \| "form_data" \| "raw"	Body Type
`body`optional	object (depends on other props)	Body
`response_is_binary`optional	boolean	Enable for files like PDFs, images, etc.
`failsafe`optional	boolean	No Error on Failure
`timeout`optional	number	Timeout (in seconds)
`followRedirects`optional	boolean	Follow redirects

Details

Id: fillout-forms
Category: Other
Tags: forms, submissions, no-code
Package: @activepieces/piece-fillout-forms@0.1.4
Tier: Community