formbricks/apps/docs/app/developer-docs/integrations/activepieces/page.mdx

import { MdxImage } from "@/components/mdx-image";

import CreateConnection from "./create-connection.webp";
import CreateNewFlow from "./create-new-flow.webp";
import DuplicateSurvey from "./duplicate-survey.webp";
import ConfigureConnection from "./configure-connection.webp";
import SearchFormbricks from "./search-formbricks.webp";
import SelectSurvey from "./select-survey.webp";
import TestTrigger from "./test-trigger.webp";
import UpdateQuestionId from "./update-question-id.webp";
import SuccessResponse from "./success-response.webp";
import SelectGSSheet from "./select-gs-sheet.webp";
import SelectGoogleSheet from "./select-google-sheet.webp";
import MatchData from "./match-data.webp";
import Result from "./result.webp";
    
export const metadata = {
  title: "Formbricks Integration with Activepieces: A Step-by-Step Guide",
  description:
    "Learn how to integrate Formbricks with Activepieces. Follow our detailed guide to set up workflows, connect with various apps, and send your survey data to multiple platforms.",
};

#### Integrations

# Activepieces Setup

Activepieces is a versatile tool to automate workflows between Formbricks and numerous applications. Here's how to set it up.

<Note>
  Ensure your survey is finalized before setting up Activepieces. Any changes in the survey will require additional adjustments in the workflow.
</Note>

## Step 1: Setup your survey incl. `questionId` for every question

Set up the `questionId`s of your survey questions before publishing.

<MdxImage
  src={UpdateQuestionId}
  alt="Update Question ID"
  quality="100"
  className="max-w-full rounded-lg sm:max-w-3xl"
/>

_Update the Question ID field in every question card under Advanced Settings._

<Note>
  Already published? Duplicate survey You can only update the questionId before publishing the survey. If already published, simply duplicate it.
  <MdxImage
    src={DuplicateSurvey}
    alt="Duplicate Survey"
    quality="100"
    className="max-w-full rounded-lg sm:max-w-3xl"
  />
</Note>

## Step 2: Setup Activepieces

Visit [Activepieces](https://activepieces.com) to start a new Flow.

<MdxImage
  src={CreateNewFlow}
  alt="Create New Flow"
  quality="100"
  className="max-w-full rounded-lg sm:max-w-3xl"
/>

Search for `Formbricks` and choose the event to trigger the flow, we will choose `Response Finished` here

<MdxImage
  src={SearchFormbricks}
  alt="Search Formbricks"
  quality="100"
  className="max-w-full rounded-lg sm:max-w-3xl"
/>

## Step 3: Connect Formbricks with Activepieces

Click on `Create connection`:

<MdxImage
  src={CreateConnection}
  alt="Create Connection"
  quality="100"
  className="max-w-full rounded-lg sm:max-w-3xl"
/>

Enter the Formbricks API Host and API Key. API Host is by default set to https://app.formbricks.com but can be modified for self-hosting instances. Learn how to get an API Key from the [API Key tutorial](/additional-features/api#how-to-generate-an-api-key).

<MdxImage
  src={ConfigureConnection}
  alt="Configure Connection"
  quality="100"
  className="max-w-full rounded-lg sm:max-w-3xl"
/>

## Step 4: Select Survey

Choose from your created surveys:

<MdxImage
  src={SelectSurvey}
  alt="Select Survey"
  quality="100"
  className="max-w-full rounded-lg sm:max-w-3xl"
/>

## Step 5: Send a test response

You need a test response for Activepieces setup. Click on Test trigger and submit a test response in the connected Formbricks survey to see the data in Activepieces.

<MdxImage
  src={TestTrigger}
  alt="Test Trigger"
  quality="100"
  className="max-w-full rounded-lg sm:max-w-3xl"
/>

If the test response is successful, you will see the data in Activepieces.

<MdxImage
  src={SuccessResponse}
  alt="Success Response"
  quality="100"
  className="max-w-full rounded-lg sm:max-w-3xl"
/>

## Step 6: Set up Google Sheet

Decide on the desired action for the data. Here, we'll send submissions to a Google Sheet. Add Google sheet step to your flow and configure it as follows:
Choose "Add a Row" for the action. Authenticate with Google and select the spreadsheet you want to add the data to.

<MdxImage
  src={SelectGSSheet}
  alt="Select Google sheet"
  quality="100"
  className="max-w-full rounded-lg sm:max-w-3xl"
/>

Specify the fields you want to add to the spreadsheet.

<MdxImage
  src={MatchData}
  alt="Match Data"
  quality="100"
  className="max-w-full rounded-lg sm:max-w-3xl"
/>

A new row gets added to the spreadsheet for every response:

<MdxImage
  src={Result}
  alt="Result"
  quality="100"
  className="max-w-full rounded-lg sm:max-w-3xl"
/>