Mandatory Headers

Request

Response

Here is how you can test your API key to make sure it is working.

Test API Key

Documentation - Feedbackflow

Welcome to the Feedbackflow Documentation!

Introduction

Get to know Feedbackflow and its capabilities.

What is Feedbackflow?

Learn how Feedbackflow helps you gather, analyse, and report experience data.

XM & Surveys

 Feedbackflow provides two APIs: the Public Client API for frontend survey interactions and the Management API for backend management tasks.

REST API

Here is how you can generate an API key which gives you full access to the Feedbackflow Management API. Keep it safe!

Generate API Key

Update an existing response for example when you want to mark a response as finished or you want to change an existing response's value.

Update Response

Create a response for a survey and it's fields with the user's responses. The userId & meta here is optional

Create Response

Update a contact's attributes in Formbricks to keep them in sync with your app or when you want to set a custom attribute in Formbricks.

Update Contact (Attributes)

Retrieves a contact's state including their segments, displays, responses and other tracking information. If the contact doesn't exist, it will be created.

Get Contact State

Create a new display for a valid survey ID. If a userId is passed, the display is linked to the user.

Create Display

Update an Display for a user. A use case can be when a user submits a response & you want to link it to an existing display.

Update Display

Retrieves the environment state to be used in Formbricks SDKs

Get Environment State

Endpoint for creating or identifying a user within the specified environment. If the user already exists, this will identify them and potentially update user attributes. If they don't exist, it will create a new user.


Create or Identify User

Fetches all the action classes available in the environment

Get All Action Classes

Create Action Class from the UI or from the API! You can read more about them [here](https://feedbackflowhq.com/docs/in-app-surveys/actions).

Create Action Class

Get Action Class by ID

Delete Action Class

Fetches all the available attribute classes

Get All Attribute Classes

Create a new Attribute Class by passing in its type as well as the name! Now just use them in your app and pass this value with a user & it'll be associated with it.

Create Attribute Class

Get Attribute Class by ID

Delete an attribute class by its ID. Please note that you currently cannot delete the "automatic" type of attributes. Please ignore them if you do not wish to utilise them.

Delete Attribute Class

Retrieve a list of all contact attribute keys defined in the current environment

Get All Contact Attribute Keys

Retrieve a specific contact attribute key by its ID. This returns detailed information about how a particular attribute is defined in your environment.

Get Contact Attribute Key by ID

Retrieve a list of all contact attributes in the current environment

Get All Contact Attributes

Retrieve a list of all contacts for the current environment

Get All Contacts

Get Contact by ID

Fetches the product associated with the passed API key

Get all the identified people from Formbricks

Get All Persons

Get a person by their internal ID on Formbricks. This internal ID can be found from the Get All Person endpoint.

Get Person by ID

Delete an identified person from Formbricks.

Delete Person

Pass the surveyId as a Query Parameter & only fetch responses for a specific survey that you have access to.

Get Survey Responses

Create a user response using the management API

Fetch the entire response object based on its ID

Get Response by ID

Update an existing user response with new data

Delete Response

API endpoint for uploading public files. Uploaded files are public and accessible by anyone. This endpoint requires authentication. It accepts a JSON body with fileName, fileType, environmentId, and optionally allowedFileExtensions to restrict file types. On success, it returns a signed URL for uploading the file to S3 along with a local upload URL.

Upload Public File

Management API endpoint for uploading public files to local storage. This endpoint requires authentication. File metadata is provided via headers (X-File-Type, X-File-Name, X-Environment-ID, X-Signature, X-UUID, X-Timestamp) and the file is provided as a multipart/form-data file field named "file". The "Content-Type" header must be set to a valid MIME type.

Upload Public File to Local Storage

Get All Surveys

Create a survey with granular settings, questions, their types, welcomeCard, thankYouCard, languages, etc right from this API. We'd however recommend you to do this via our Formbricks App with the UI for a better visual experience.

Create Survey

Get Survey by ID

Update an existing survey with new properties. This is also what we'd recommend you to do from the UI for a better visual feedback.

Update Survey

Delete a Survey by its ID. Please use this only when extrememly necessary.

Delete Survey

Generates multiple single use survey links for a survey based on its id.

Get SingleUse Links

Retrieve a list of all webhooks for the current environment

Get All Webhooks

Create a new webhook right from the API and see it active right away!

Create Webhook

Get a specific webhook object based on its ID

Get Webhook

Delete an existing webhook by provifding it's ID. It will immediately apply and not trigger again.

Delete Webhook

Formbricks' Health Check endpoint to make sure the App & the Database are connected with each other & up!

Health Check

API v1 Reference

Go to app

Support

Enhance your questions by adding images or videos. This makes instructions clearer and the survey more engaging.

Add Image / Video

Create complex survey logic with the Logic Editor. Use conditions, actions, and variables to create a personalized survey experience.

Conditional Logic

Overwrite the global styling theme for individual surveys to create unique styles for each survey.

Custom Styling

Add data to a submission without asking the user to type it in. This feature is especially useful when you already have information about a user that you want to use in the analysis of the survey results (e.g. `payment plan` or `email`).

Hidden Fields

Automatically close your survey after reaching a set number of responses in Feedbackflow. This is useful for limited offers, exclusive surveys, or when you need a specific sample size.

Limit Submissions

Create surveys that support multiple languages using translations. This helps you reach a diverse audience without making separate surveys for each language. It also simplifies survey creation, delivery, and analysis for multilingual audiences.

Multi-language Surveys

Capture and analyze partial submissions, providing detailed insights into how participants interact with each question within your survey. This feature is crucial for identifying specific points where respondents may disengage, allowing you to understand and address drop-offs effectively.

Partial Submissions

Personalize your surveys by dynamically inserting data from URL parameters or previous answers into questions and descriptions. The Recall Data feature helps create engaging, adaptive survey experiences tailored to each respondent.

Recall Data

Create public, shareable versions of your survey results dashboards. This feature enables you to easily share survey results with stakeholders, team members, or the public without granting access to your Feedbackflow account.

Shareable Dashboards

Optimize your survey management with custom Start & End Conditions in Feedbackflow. This feature allows you to control exactly when your survey is available for responses and when it should close, making it ideal for time-sensitive or number-of-response-limited surveys.

Schedule Start & End Dates

Feedbackflow captures metadata of your users for you when they fill a survey. This metadata is useful for understanding the context in which the user filled the survey. For example, if you are running a marketing campaign, you can understand which source is driving the most responses. Or if you are running a survey on a specific page, you can understand the user's behavior on that page.

User Metadata

Variables are a powerful feature in Feedbackflow that allows you to keep track of data variables when user fills a form. This feature is especially useful when you want to use your survey as a quiz.

Variables

Learn how to hide the back button in surveys.

Hide Back Button

Follow-ups are a feature that allows you to send emails to your users on different survey events.

Email Follow-ups

Create your first link survey in under 5 minutes.

Quickstart - Link Surveys

App surveys deliver 6–10x higher conversion rates compared to email surveys. If you are new to Feedbackflow, follow the steps in this guide to launch a survey in your web or mobile app (React Native) within 10–15 minutes.

Quickstart - Web & App Surveys

Easily add the Feedbackflow App Survey SDK to your app with guides for different frameworks.

Framework Guides

The Address question type allows respondents to input their address details, including multiple fields such as address lines, city, state, and country. You can configure the question by adding a title, an optional description, and toggling specific fields to be required.

Address

The Consent card is used to obtain user agreement regarding a product, service, or policy. It features a bold statement or question as the title, followed by a brief description. At the end of the card, users can confirm their consent by checking a checkbox to indicate their agreement.

Consent

The Contact Info question type allows respondents to provide their basic contact information such as name, email, and phone number. You can customize the form with a title, an optional description, and control which fields to display and require.

Contact Info

The Date question type allows respondents to provide a date, such as when they are available or when an event is scheduled. It features a title to guide the respondent on what date to enter, and an optional description to provide further details or context.

Date

The File Upload question type allows respondents to upload files related to your survey, such as production documents or requirement specifications. It features a title to guide the user on what to upload and an optional description to provide additional context.

File Upload

Free text questions allow respondents to enter a custom answer.

Free Text

Matrix questions allow respondents to select a value for each option presented in rows.

Matrix

Net Promoter Score questions allow respondents to rate a question on a scale from 0 to 10. Displays a title and a list of radio buttons for the respondent to choose from.

Net Promoter Score

Ranking questions let respondents select options in order from 1 to the total number of options. As they make their choices, the list is automatically rearranged in numerical order.

Ranking

Rating questions allow respondents to rate questions on a scale

Rating

The Schedule A Meeting question type allows respondents to book a meeting by selecting a date and time. It includes a title to guide the respondent, along with an optional description to provide additional context for the meeting setup.

Schedule A Meeting

Multi select questions allow respondents to select several answers from a list

Multi Select

Picture selection questions allow respondents to select one or more images from a list

Picture Selection

Single select questions allow respondents to select one answer from a list

Single Select

The Statement question type allows you to display descriptive information in your survey, such as a message or instruction. 

Statement (Call to Action)

A step-by-step guide to integrate Kit with Feedbackflow.

Name	x-Api-Key
Type	string
Description	Your Feedbackflow API key.

API v1 Documentation

Client API > Response

Client API > Contacts

Client API > Display

Client API > Environment

Client API > User

Management API > Action Class

Management API > Attribute Class

Management API > Contact Attribute Keys

Management API > Contact Attributes

Management API > Contacts

Management API > Me

Management API > People

Management API > Response

Management API > Storage

Management API > Survey

Management API > Webhook

Health

Test API Key

Mandatory Headers

Request

Response

API v1 Documentation

Client API > Response

Client API > Contacts

Client API > Display

Client API > Environment

Client API > User

Management API > Action Class

Management API > Attribute Class

Management API > Contact Attribute Keys

Management API > Contact Attributes

Management API > Contacts

Management API > Me

Management API > People

Management API > Response

Management API > Storage

Management API > Survey

Management API > Webhook

Health

​Mandatory Headers

​Request

​Response

Mandatory Headers

Request

Response