# Documentation - Formbricks ## Docs - [Get Contact State](https://formbricks.com/docs/api-reference/client-api--contacts/get-contact-state.md): Retrieves a contact's state including their segments, displays, responses and other tracking information. If the contact doesn't exist, it will be created. - [Update Contact (Attributes)](https://formbricks.com/docs/api-reference/client-api--contacts/update-contact-attributes.md): 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. - [Create Display](https://formbricks.com/docs/api-reference/client-api--display/create-display.md): Create a new display for a valid survey ID. If a userId is passed, the display is linked to the user. - [Update Display](https://formbricks.com/docs/api-reference/client-api--display/update-display.md): 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. - [Get Environment State](https://formbricks.com/docs/api-reference/client-api--environment/get-environment-state.md): Retrieves the environment state to be used in Formbricks SDKs **Cache Behavior**: This endpoint uses server-side caching with a **5-minute TTL (Time To Live)**. Any changes to surveys, action classes, project settings, or other environment data will take up to 5 minutes to reflect in the API respons… - [Create Response](https://formbricks.com/docs/api-reference/client-api--response/create-response.md): Create a response for a survey and it's fields with the user's responses. The userId & meta here is optional - [Update Response](https://formbricks.com/docs/api-reference/client-api--response/update-response.md): 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. - [Create or Identify User](https://formbricks.com/docs/api-reference/client-api--user/create-or-identify-user.md): 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. - [Generate API Key](https://formbricks.com/docs/api-reference/generate-key.md): Here is how you can generate an API key which gives you full access to the Formbricks Management API. Keep it safe! - [Health Check](https://formbricks.com/docs/api-reference/health/health-check.md): Check the health status of critical application dependencies including database and cache. - [Create Action Class](https://formbricks.com/docs/api-reference/management-api--action-class/create-action-class.md): Create Action Class from the UI or from the API! You can read more about them [here](https://formbricks.com/docs/in-app-surveys/actions). - [Delete Action Class](https://formbricks.com/docs/api-reference/management-api--action-class/delete-action-class.md): Deletes an existing action class - [Get Action Class by ID](https://formbricks.com/docs/api-reference/management-api--action-class/get-action-class-by-id.md): Fetch an Action Class by it's ID - [Get All Action Classes](https://formbricks.com/docs/api-reference/management-api--action-class/get-all-action-classes.md): Fetches all the action classes available in the environment - [Create Attribute Class](https://formbricks.com/docs/api-reference/management-api--attribute-class/create-attribute-class.md): 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. - [Delete Attribute Class](https://formbricks.com/docs/api-reference/management-api--attribute-class/delete-attribute-class.md): 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. - [Get All Attribute Classes](https://formbricks.com/docs/api-reference/management-api--attribute-class/get-all-attribute-classes.md): Fetches all the available attribute classes - [Get Attribute Class by ID](https://formbricks.com/docs/api-reference/management-api--attribute-class/get-attribute-class-by-id.md): Fetches an Attribute Class by its ID - [Get All Contact Attribute Keys](https://formbricks.com/docs/api-reference/management-api--contact-attribute-keys/get-all-contact-attribute-keys.md): Retrieve a list of all contact attribute keys defined in the current environment - [Get Contact Attribute Key by ID](https://formbricks.com/docs/api-reference/management-api--contact-attribute-keys/get-contact-attribute-key-by-id.md): Retrieve a specific contact attribute key by its ID. This returns detailed information about how a particular attribute is defined in your environment. - [Get All Contact Attributes](https://formbricks.com/docs/api-reference/management-api--contact-attributes/get-all-contact-attributes.md): Retrieve a list of all contact attributes in the current environment - [Get All Contacts](https://formbricks.com/docs/api-reference/management-api--contacts/get-all-contacts.md): Retrieve a list of all contacts for the current environment - [Get Contact by ID](https://formbricks.com/docs/api-reference/management-api--contacts/get-contact-by-id.md): Retrieve a specific contact by its ID - [Me](https://formbricks.com/docs/api-reference/management-api--me/me.md): Fetches the product associated with the passed API key - [Delete Person](https://formbricks.com/docs/api-reference/management-api--people/delete-person.md): Delete an identified person from Formbricks. - [Get All Persons](https://formbricks.com/docs/api-reference/management-api--people/get-all-persons.md): Get all the identified people from Formbricks - [Get Person by ID](https://formbricks.com/docs/api-reference/management-api--people/get-person-by-id.md): Get a person by their internal ID on Formbricks. This internal ID can be found from the Get All Person endpoint. - [Create Response](https://formbricks.com/docs/api-reference/management-api--response/create-response.md): Create a user response using the management API. This will trigger the response pipeline, including webhooks, integrations, follow-up emails, and other configured actions. - [Delete Response](https://formbricks.com/docs/api-reference/management-api--response/delete-response.md): Delete a response with its ID - [Get Response by ID](https://formbricks.com/docs/api-reference/management-api--response/get-response-by-id.md): Fetch the entire response object based on its ID - [Get Survey Responses](https://formbricks.com/docs/api-reference/management-api--response/get-survey-responses.md): Pass the surveyId as a Query Parameter & only fetch responses for a specific survey that you have access to. - [Update Response](https://formbricks.com/docs/api-reference/management-api--response/update-response.md): Update an existing user response with new data. This will trigger the response pipeline, including webhooks, integrations, follow-up emails (if the response is marked as finished), and other configured actions. - [Upload Public File](https://formbricks.com/docs/api-reference/management-api--storage/upload-public-file.md): API endpoint for uploading public files. Uploaded files are public and accessible by anyone. This endpoint requires authentication and enforces a hard limit of 5 MB for all uploads. It accepts a JSON body with fileName, fileType, environmentId, and optionally allowedFileExtensions to restrict file t… - [Create Survey](https://formbricks.com/docs/api-reference/management-api--survey/create-survey.md): 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. - [Delete Survey](https://formbricks.com/docs/api-reference/management-api--survey/delete-survey.md): Delete a Survey by its ID. Please use this only when extrememly necessary. - [Get All Surveys](https://formbricks.com/docs/api-reference/management-api--survey/get-all-surveys.md): Fetches all existing surveys - [Get SingleUse Links](https://formbricks.com/docs/api-reference/management-api--survey/get-singleuse-links.md): Generates multiple single use survey links for a survey based on its id. - [Get Survey by ID](https://formbricks.com/docs/api-reference/management-api--survey/get-survey-by-id.md): Fetch a survey object based on its ID - [Update Survey](https://formbricks.com/docs/api-reference/management-api--survey/update-survey.md): 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. - [Create Webhook](https://formbricks.com/docs/api-reference/management-api--webhook/create-webhook.md): Create a new webhook right from the API and see it active right away! - [Delete Webhook](https://formbricks.com/docs/api-reference/management-api--webhook/delete-webhook.md): Delete an existing webhook by provifding it's ID. It will immediately apply and not trigger again. - [Get All Webhooks](https://formbricks.com/docs/api-reference/management-api--webhook/get-all-webhooks.md): Retrieve a list of all webhooks for the current environment - [Get Webhook](https://formbricks.com/docs/api-reference/management-api--webhook/get-webhook.md): Get a specific webhook object based on its ID - [REST API](https://formbricks.com/docs/api-reference/rest-api.md): Formbricks provides two APIs: the Public Client API for frontend survey interactions and the Management API for backend management tasks. - [Test API Key](https://formbricks.com/docs/api-reference/test-key.md): Here is how you can test your API key to make sure it is working. - [Get Contact State](https://formbricks.com/docs/api-v2-reference/client-api--contacts/get-contact-state.md): Retrieves a contact's state including their segments, displays, responses and other tracking information. If the contact doesn't exist, it will be created. - [Update Contact (Attributes)](https://formbricks.com/docs/api-v2-reference/client-api--contacts/update-contact-attributes.md): 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. - [Create Display](https://formbricks.com/docs/api-v2-reference/client-api--display/create-display.md): Create a new display for a valid survey ID. If a userId is passed, the display is linked to the user. - [Get Environment State](https://formbricks.com/docs/api-v2-reference/client-api--environment/get-environment-state.md): Retrieves the environment state to be used in Formbricks SDKs. **Cache Behavior**: This endpoint uses server-side caching with a **5-minute TTL (Time To Live)**. Any changes to surveys, action classes, project settings, or other environment data will take up to 5 minutes to reflect in the API respon… - [Upload Private File](https://formbricks.com/docs/api-v2-reference/client-api--file-upload/upload-private-file.md): API endpoint for uploading private files. Uploaded files are kept private so that only users with access to the specified environment can retrieve them. The endpoint validates the survey ID, file name, and file type from the request body, and returns a signed URL for S3 uploads along with a local up… - [Create Response](https://formbricks.com/docs/api-v2-reference/client-api--response/create-response.md): Create a response for a survey and its fields with the user's responses. The userId & meta here is optional - [Update Response](https://formbricks.com/docs/api-v2-reference/client-api--response/update-response.md): 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. - [Create or Identify User](https://formbricks.com/docs/api-v2-reference/client-api--user/create-or-identify-user.md): 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. - [Health Check](https://formbricks.com/docs/api-v2-reference/health/health-check.md): Check the health status of critical application dependencies including database and cache. - [API v2 Reference (Beta)](https://formbricks.com/docs/api-v2-reference/introduction.md) - [Create a contact attribute key](https://formbricks.com/docs/api-v2-reference/management-api--contact-attribute-keys/create-a-contact-attribute-key.md): Creates a contact attribute key in the database. - [Delete a contact attribute key](https://formbricks.com/docs/api-v2-reference/management-api--contact-attribute-keys/delete-a-contact-attribute-key.md): Deletes a contact attribute key from the database. - [Get a contact attribute key](https://formbricks.com/docs/api-v2-reference/management-api--contact-attribute-keys/get-a-contact-attribute-key.md): Gets a contact attribute key from the database. - [Get contact attribute keys](https://formbricks.com/docs/api-v2-reference/management-api--contact-attribute-keys/get-contact-attribute-keys.md): Gets contact attribute keys from the database. - [Update a contact attribute key](https://formbricks.com/docs/api-v2-reference/management-api--contact-attribute-keys/update-a-contact-attribute-key.md): Updates a contact attribute key in the database. - [Create a contact](https://formbricks.com/docs/api-v2-reference/management-api--contacts/create-a-contact.md): Creates a single contact in the database. This endpoint expects a top-level `attributes` object. For bulk uploads, use `PUT /management/contacts/bulk`, which expects `contacts[].attributes[]` instead. Each contact must have a valid email address in the attributes. All attribute keys must already exi… - [Upload Bulk Contacts](https://formbricks.com/docs/api-v2-reference/management-api--contacts/upload-bulk-contacts.md): Uploads contacts in bulk. This endpoint expects the bulk request shape: `contacts` must be an array, and each contact item must contain an `attributes` array of `{ attributeKey, value }` objects. Unlike `POST /management/contacts`, this endpoint does not accept a top-level `attributes` object. Each… - [Create a response](https://formbricks.com/docs/api-v2-reference/management-api--responses/create-a-response.md): Creates a response in the database. This will trigger the response pipeline, including webhooks, integrations, follow-up emails, and other configured actions. - [Delete a response](https://formbricks.com/docs/api-v2-reference/management-api--responses/delete-a-response.md): Deletes a response from the database. - [Get a response](https://formbricks.com/docs/api-v2-reference/management-api--responses/get-a-response.md): Gets a response from the database. - [Get responses](https://formbricks.com/docs/api-v2-reference/management-api--responses/get-responses.md): Gets responses from the database. - [Update a response](https://formbricks.com/docs/api-v2-reference/management-api--responses/update-a-response.md): Updates a response in the database. This will trigger the response pipeline, including webhooks, integrations, follow-up emails (if the response is marked as finished), and other configured actions. - [Get personalized survey link for a contact](https://formbricks.com/docs/api-v2-reference/management-api--surveys--contact-links/get-personalized-survey-link-for-a-contact.md): Retrieves a personalized link for a specific survey. - [Get survey links for contacts in a segment](https://formbricks.com/docs/api-v2-reference/management-api--surveys--contact-links/get-survey-links-for-contacts-in-a-segment.md): Generates personalized survey links for contacts in a segment. - [Create a webhook](https://formbricks.com/docs/api-v2-reference/management-api--webhooks/create-a-webhook.md): Creates a webhook in the database. - [Delete a webhook](https://formbricks.com/docs/api-v2-reference/management-api--webhooks/delete-a-webhook.md): Deletes a webhook from the database. - [Get a webhook](https://formbricks.com/docs/api-v2-reference/management-api--webhooks/get-a-webhook.md): Gets a webhook from the database. - [Get webhooks](https://formbricks.com/docs/api-v2-reference/management-api--webhooks/get-webhooks.md): Gets webhooks from the database. - [Update a webhook](https://formbricks.com/docs/api-v2-reference/management-api--webhooks/update-a-webhook.md): Updates a webhook in the database. - [Me](https://formbricks.com/docs/api-v2-reference/me/me.md): Fetches the projects and organizations associated with the API key. - [Create a projectTeam](https://formbricks.com/docs/api-v2-reference/organizations-api--project-teams/create-a-projectteam.md): Creates a project team in the database. - [Delete a project team](https://formbricks.com/docs/api-v2-reference/organizations-api--project-teams/delete-a-project-team.md): Deletes a project team from the database. - [Get project teams](https://formbricks.com/docs/api-v2-reference/organizations-api--project-teams/get-project-teams.md): Gets projectTeams from the database. - [Update a project team](https://formbricks.com/docs/api-v2-reference/organizations-api--project-teams/update-a-project-team.md): Updates a project team in the database. - [Create a team](https://formbricks.com/docs/api-v2-reference/organizations-api--teams/create-a-team.md): Creates a team in the database. - [Delete a team](https://formbricks.com/docs/api-v2-reference/organizations-api--teams/delete-a-team.md): Deletes a team from the database. - [Get a team](https://formbricks.com/docs/api-v2-reference/organizations-api--teams/get-a-team.md): Gets a team from the database. - [Get teams](https://formbricks.com/docs/api-v2-reference/organizations-api--teams/get-teams.md): Gets teams from the database. - [Update a team](https://formbricks.com/docs/api-v2-reference/organizations-api--teams/update-a-team.md): Updates a team in the database. - [Create a user](https://formbricks.com/docs/api-v2-reference/organizations-api--users/create-a-user.md): Create a new user in the database.
Only available for self-hosted Formbricks. - [Get users](https://formbricks.com/docs/api-v2-reference/organizations-api--users/get-users.md): Gets users from the database.
Only available for self-hosted Formbricks. - [Update a user](https://formbricks.com/docs/api-v2-reference/organizations-api--users/update-a-user.md): Updates an existing user in the database.
Only available for self-hosted Formbricks. - [Get roles](https://formbricks.com/docs/api-v2-reference/roles/get-roles.md): Gets roles from the database. - [Contribute to Formbricks](https://formbricks.com/docs/development/contribution/contribution.md): How to contribute to Formbricks - [Setup SAML with Identity Providers](https://formbricks.com/docs/development/guides/auth-and-provision/setup-saml-with-identity-providers.md): This guide explains the settings you need to use to configure SAML with your Identity Provider. Once configured, obtain an XML metadata file and use it to configure SAML in Formbricks. - [GitHub Codespaces](https://formbricks.com/docs/development/local-setup/github-codespaces.md): How to set up Formbricks in a GitHub Codespaces environment - [Gitpod](https://formbricks.com/docs/development/local-setup/gitpod.md): How to set up Formbricks in a Gitpod workspace - [Linux](https://formbricks.com/docs/development/local-setup/linux.md): How to set up Formbricks on a Linux machine - [Mac](https://formbricks.com/docs/development/local-setup/mac.md): How to set up Formbricks on a Mac machine - [Windows](https://formbricks.com/docs/development/local-setup/windows.md): How to set up Formbricks on a Windows machine - [Overview](https://formbricks.com/docs/development/overview.md): Learn how to setup formbricks locally and build custom integrations and services. - [File and Directory Org.](https://formbricks.com/docs/development/standards/organization/file-and-directory-organization.md): This document outlines the structure and organization of files and directories in the Formbricks codebase, providing guidelines for maintaining consistency and clarity across the project. - [Modules & Components](https://formbricks.com/docs/development/standards/organization/module-component-structure.md): In this document we outline the best practices for organizing modules and components across the codebase. Clear separation of concerns between modules (which encompass business logic and domain-specific functionality) and components (reusable UI elements and building blocks) promotes clarity, scalab… - [Naming Conventions](https://formbricks.com/docs/development/standards/organization/naming-conventions.md): This section outlines the guidelines for naming conventions across the codebase, ensuring consistency and clarity in the project. - [Code Formatting](https://formbricks.com/docs/development/standards/practices/code-formatting.md): Standards for consistent code formatting across the Formbricks project - [Documentation](https://formbricks.com/docs/development/standards/practices/documentation.md): Standards for documenting code and features in the Formbricks codebase - [Error Handling](https://formbricks.com/docs/development/standards/practices/error-handling.md): Standards for handling errors across the Formbricks codebase - [Code Reviews](https://formbricks.com/docs/development/standards/qa/code-reviews.md): This document outlines our comprehensive code review process at Formbricks. We maintain high quality, consistency, and best practices within our codebase through this structured approach. - [Testing Methodology](https://formbricks.com/docs/development/standards/qa/testing-methodology.md): How we test Formbricks to ensure reliability, performance, and high-quality code. - [Framework Usage](https://formbricks.com/docs/development/standards/technical/framework-usage.md): Guidelines on how Formbricks utilizes Next.js, Tailwind CSS, and Prisma ORM for efficient development and performance. - [Language-Specific](https://formbricks.com/docs/development/standards/technical/language-specific-conventions.md): This document outlines the language-specific conventions for the Formbricks codebase, providing guidelines for writing code in TypeScript/JavaScript. - [Troubleshooting](https://formbricks.com/docs/development/support/troubleshooting.md): Here, you'll find help with common issues. - [Database Model](https://formbricks.com/docs/development/technical-handbook/database-model.md): Overview of the Formbricks database schema and relationships - [Solution Overview](https://formbricks.com/docs/development/technical-handbook/overview.md): High-level architecture and technical details of the Formbricks platform - [Tenant Separation](https://formbricks.com/docs/development/technical-handbook/tenant-separation.md): How Formbricks handles tenant separation on Formbricks Cloud - [Introduction](https://formbricks.com/docs/overview/introduction.md): Welcome to the Formbricks Documentation! - [Open-Source](https://formbricks.com/docs/overview/open-source.md): Open-source Experience Management. Free & open source. - [What is Formbricks?](https://formbricks.com/docs/overview/what-is-formbricks.md): Get to know Formbricks and its capabilities. - [Audit Logging](https://formbricks.com/docs/self-hosting/advanced/enterprise-features/audit-logging.md): Enable comprehensive audit logs for your Formbricks instance. - [Contact management & segments](https://formbricks.com/docs/self-hosting/advanced/enterprise-features/contact-management-segments.md): Create and manage contacts and attribute-based segments with Formbricks. - [Hide 'Powered by Formbricks' signature](https://formbricks.com/docs/self-hosting/advanced/enterprise-features/hide-powered-by-formbricks.md): Hide our brand signature for a more white-labeled experience. - [OAuth & SSO](https://formbricks.com/docs/self-hosting/advanced/enterprise-features/oidc-sso.md): Configure Single Sign-On with your Formbricks instance. - [SAML SSO](https://formbricks.com/docs/self-hosting/advanced/enterprise-features/saml-sso.md): Configure Single Sign-On with SAML for your Formbricks instance. - [Teams & Roles (RBAC)](https://formbricks.com/docs/self-hosting/advanced/enterprise-features/team-access.md): Granularly control which users have access to specific projects and surveys. - [White-label Follow-ups](https://formbricks.com/docs/self-hosting/advanced/enterprise-features/whitelabel-email-follow-ups.md): Add you own logo to emails sent to respondents - [License](https://formbricks.com/docs/self-hosting/advanced/license.md): License for Formbricks - [License Activation](https://formbricks.com/docs/self-hosting/advanced/license-activation.md): How to activate your Formbricks Enterprise License - [Migration](https://formbricks.com/docs/self-hosting/advanced/migration.md): Formbricks Self-hosted version migration - [Rate Limiting](https://formbricks.com/docs/self-hosting/advanced/rate-limiting.md): Current request rate limits in Formbricks - [Authentication Behavior](https://formbricks.com/docs/self-hosting/auth-behavior.md): Learn how authentication and user invitation work in self-hosted Formbricks deployments. - [Azure AD OAuth](https://formbricks.com/docs/self-hosting/configuration/auth-sso/azure-ad-oauth.md): Configure Microsoft Entra ID (Azure AD) OAuth for secure Single Sign-On with your Formbricks instance. Use enterprise-grade authentication for your survey platform. - [Google OAuth](https://formbricks.com/docs/self-hosting/configuration/auth-sso/google-oauth.md): Configure Google OAuth for secure Single Sign-On with your Formbricks instance. Implement enterprise-grade authentication for your survey platform with Google credentials. - [Keycloak OIDC](https://formbricks.com/docs/self-hosting/configuration/auth-sso/keycloak-oidc.md): Configure Keycloak as an OpenID Connect (OIDC) provider for secure Single Sign-On with your self-hosted Formbricks instance. - [Open ID Connect](https://formbricks.com/docs/self-hosting/configuration/auth-sso/open-id-connect.md): Configure Open ID Connect for secure Single Sign-On with your Formbricks instance. Implement enterprise-grade authentication for your survey platform with Open ID Connect. - [SAML SSO](https://formbricks.com/docs/self-hosting/configuration/auth-sso/saml-sso.md): Configure SAML Single Sign-On (SSO) for secure enterprise authentication with your Formbricks instance. - [CDN](https://formbricks.com/docs/self-hosting/configuration/cdn.md): Use a CDN in front of public Formbricks traffic without serving stale survey assets after upgrades. - [Custom SSL Certificate](https://formbricks.com/docs/self-hosting/configuration/custom-ssl.md): Using Formbricks One-Click Setup with a Custom SSL Certificate. - [Custom Subpath](https://formbricks.com/docs/self-hosting/configuration/custom-subpath.md): Serve Formbricks from a custom URL prefix when you cannot expose it on the root domain. - [Domain Configuration](https://formbricks.com/docs/self-hosting/configuration/domain-configuration.md): Configuring your domain for Formbricks. - [Environment Variables](https://formbricks.com/docs/self-hosting/configuration/environment-variables.md): Environment variables for Formbricks - [File Uploads Configuration](https://formbricks.com/docs/self-hosting/configuration/file-uploads.md): Configure file storage for survey images, file uploads, and project assets in your self-hosted Formbricks instance - [ActivePieces (On Premise)](https://formbricks.com/docs/self-hosting/configuration/integrations/activepieces.md): Learn how to configure ActivePieces integration in your survey for self-hosting instance. - [Airtable (On Premise)](https://formbricks.com/docs/self-hosting/configuration/integrations/airtable.md): Instantly populate your Airtable table with survey data - [Google Sheets (On Premise)](https://formbricks.com/docs/self-hosting/configuration/integrations/google-sheets.md): Instantly populate your Google Sheet table with survey data - [n8n (On Premise)](https://formbricks.com/docs/self-hosting/configuration/integrations/n8n.md): Set up automations with your self-hosted n8n instance. - [Notion (On Premise)](https://formbricks.com/docs/self-hosting/configuration/integrations/notion.md): Instantly populate a Notion database with survey data - [Slack (On Premise)](https://formbricks.com/docs/self-hosting/configuration/integrations/slack.md): Send survey responses automatically to Slack workspace. - [Zapier (On Premise)](https://formbricks.com/docs/self-hosting/configuration/integrations/zapier.md): Set up automations with your self-hosted Zapier instance. - [SMTP Configuration](https://formbricks.com/docs/self-hosting/configuration/smtp.md): Set up email functionality for your self-hosted Formbricks instance - [Self-Hosting](https://formbricks.com/docs/self-hosting/overview.md): Learn how to self-host Formbricks. - [Cluster Setup](https://formbricks.com/docs/self-hosting/setup/cluster-setup.md): How to set up Formbricks in a High-Availability Cluster - [Docker Setup](https://formbricks.com/docs/self-hosting/setup/docker.md): Set up Formbricks quickly using our ready-to-use Docker image. - [Kubernetes Deployment](https://formbricks.com/docs/self-hosting/setup/kubernetes.md): Deploy the new Helm chart on a Kubernetes cluster using Helm. - [Monitoring](https://formbricks.com/docs/self-hosting/setup/monitoring.md): Monitoring your Formbricks installation for optimal performance. - [One-Click Setup](https://formbricks.com/docs/self-hosting/setup/one-click.md): How to set up Formbricks instance with a one-click script - [Email Branding](https://formbricks.com/docs/xm-and-surveys/core-features/email-customization.md): Branding the emails that are sent to your respondents. - [Activepieces](https://formbricks.com/docs/xm-and-surveys/core-features/integrations/activepieces.md): A step-by-step guide to integrating Formbricks with Activepieces. - [Airtable](https://formbricks.com/docs/xm-and-surveys/core-features/integrations/airtable.md): A step-by-step guide to integrate Airtable with Formbricks Cloud. - [Google Sheets](https://formbricks.com/docs/xm-and-surveys/core-features/integrations/google-sheets.md): The Google Sheets integration allows you to automatically send responses to a Google Sheet of your choice. - [HubSpot](https://formbricks.com/docs/xm-and-surveys/core-features/integrations/hubspot.md): Learn how to integrate Formbricks with HubSpot to automatically create or update contacts when survey responses are submitted. - [Make](https://formbricks.com/docs/xm-and-surveys/core-features/integrations/make.md): Discover how to seamlessly integrate Formbricks with Make.com. Dive into our comprehensive guide to set up scenarios, connect with a plethora of apps, and send your survey data to more than 1000 platforms. - [n8n](https://formbricks.com/docs/xm-and-surveys/core-features/integrations/n8n.md): Integrate Formbricks with n8n for a streamlined workflow experience. - [Notion](https://formbricks.com/docs/xm-and-surveys/core-features/integrations/notion.md): The notion integration allows you to automatically send responses to a Notion database of your choice. - [Third-party Integrations](https://formbricks.com/docs/xm-and-surveys/core-features/integrations/overview.md): Configure third-party integrations with Formbricks Cloud. - [Slack](https://formbricks.com/docs/xm-and-surveys/core-features/integrations/slack.md): The slack integration allows you to automatically send responses to a Slack channel of your choice. - [Webhooks](https://formbricks.com/docs/xm-and-surveys/core-features/integrations/webhooks.md): With webhooks, you can receive real-time HTTP notifications when specific objects change in your Formbricks environment. This allows you to stay updated and trigger automated actions based on these events. - [Wordpress](https://formbricks.com/docs/xm-and-surveys/core-features/integrations/wordpress.md): Target specific visitors with a survey on your WordPress page using Formbricks for free. Show survey on specific page or on button click. - [Zapier](https://formbricks.com/docs/xm-and-surveys/core-features/integrations/zapier.md): Master the integration of Formbricks with Zapier using our detailed guide. Seamlessly connect your surveys to 5000+ apps, automate data transfers, and enhance feedback management. Start optimizing your workflow today. - [Styling Theme](https://formbricks.com/docs/xm-and-surveys/core-features/styling-theme.md): Keep the survey styling consistent over all surveys with a Styling Theme. Customize colors, fonts, buttons, inputs, and more to match your brand. - [Test Environment](https://formbricks.com/docs/xm-and-surveys/core-features/test-environment.md): Each project on Formbricks has two environments: a test environment and a production environment. The test environment is used to test your surveys through before they are sent out to your customers. - [User Management Overview](https://formbricks.com/docs/xm-and-surveys/core-features/user-management.md): Manage organization members, roles, teams, and security settings to control access and collaboration in your Formbricks organization. - [Invite members](https://formbricks.com/docs/xm-and-surveys/core-features/user-management/invite-members.md): Learn how to invite new members to your organization individually or in bulk, and manage invitation workflows. - [Organizations and roles](https://formbricks.com/docs/xm-and-surveys/core-features/user-management/organizations-and-roles.md): Understand organization-level roles and how they control access to teams, projects, and data across your Formbricks organization. - [Teams and roles](https://formbricks.com/docs/xm-and-surveys/core-features/user-management/teams-and-roles.md): Learn about team-level roles and workspace permissions that enable granular access control within teams and workspaces. - [Two-factor authentication](https://formbricks.com/docs/xm-and-surveys/core-features/user-management/two-factor-auth.md): Secure your account with an additional layer of protection using time-based codes from authenticator apps and backup codes. - [XM & Surveys](https://formbricks.com/docs/xm-and-surveys/overview.md): Learn how Formbricks helps you gather, analyse, and report experience data. - [Add Image / Video](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/add-image-or-video-question.md): Enhance your questions by adding images or videos. This makes instructions clearer and the survey more engaging. - [Conditional Logic](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/conditional-logic.md): Create complex survey logic with the Logic Editor. Use conditions, actions, and variables to create a personalized survey experience. - [Email Follow-ups](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/email-followups.md): Automatically send customized emails to respondents based on their survey responses or specific survey endings. - [Hidden Fields](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/hidden-fields.md): 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`). - [Hide Back Button](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/hide-back-button.md): Learn how to hide the back button in surveys. - [Limit Submissions](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/limit-submissions.md): Automatically close your survey after reaching a set number of responses in Formbricks. This is useful for limited offers, exclusive surveys, or when you need a specific sample size. - [User Metadata](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/metadata.md): Formbricks 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 ru… - [Multi-language Surveys](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/multi-language-surveys.md): 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. - [Custom Styling](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/overwrite-styling.md): Overwrite the global styling theme for individual surveys to create unique styles for each survey. - [Partial Submissions](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/partial-submissions.md): 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. - [Quota Management](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/quota-management.md): Control response collection by setting limits on specific segments to ensure balanced and representative survey datasets. - [Recall Data](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/recall.md): 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. - [Spam Protection](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/spam-protection.md): Enable spam protection for your surveys using Google reCAPTCHA v3. - [Tags](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/tags.md): Organize and categorize survey responses to easily filter, analyze, and manage your data. - [Validation Rules](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/validation-rules.md): Validation rules help you ensure that respondents provide data in the correct format and within expected constraints - [Variables](https://formbricks.com/docs/xm-and-surveys/surveys/general-features/variables.md): Variables are a powerful feature in Formbricks 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. - [Custom Head Scripts](https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/custom-head-scripts.md): Add tracking pixels, analytics, or custom code to your link surveys for self-hosted instances. - [Data Prefilling](https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/data-prefilling.md): URL Data Prefilling for Link Surveys in Formbricks - [Embed Surveys](https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/embed-surveys.md): Embed Formbricks surveys seamlessly into your website using an iframe & Email using code snippets. - [Link Settings](https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/link-settings.md): Customize link titles, descriptions, and preview images to make your survey links more engaging when shared on social media and other platforms. - [Market Research Panel with Prolific](https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/market-research-panel.md): Formbricks surveys can be integrated with Prolifics participant panel easily. This tutorial walks you through the steps on how to access a pool of over 200.000 participants for your research. - [Offline Support](https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/offline-support.md): Allow respondents to complete link surveys even without an internet connection. - [Personal Links](https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/personal-links.md): Personal Links enable you to generate unique survey links for individual contacts, allowing you to attribute responses directly to specific people and set expiry dates for better control over survey distribution. - [PIN Protected Surveys](https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/pin-protected-surveys.md): Enhance the security and exclusivity of your surveys by requiring respondents to enter a secure 4 digit PIN to access your survey. Learn how to enable PIN protection and the benefits it offers. - [Quickstart - Link Surveys](https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/quickstart.md): Create your first link survey in under 5 minutes. - [Single-Use Links](https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/single-use-links.md): Make sure that each respondent only replies once with single use links. - [Source Tracking](https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/source-tracking.md): Track the source of your users in an easy & compliant way! - [Start At Specific Block](https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/start-at-block.md): Start a survey at a specific block using the URL to skip earlier blocks. - [Verify Email](https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/verify-email-before-survey.md): Verify email before accessing surveys - [Address](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/address.md): 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. - [Consent](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/consent.md): 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. - [Contact Info](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/contact-info.md): 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. - [Date](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/date.md): 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. - [File Upload](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/file-upload.md): 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. - [Free Text](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/free-text.md): Free text questions allow respondents to enter a custom answer. - [Matrix](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/matrix.md): Matrix questions allow respondents to select a value for each option presented in rows. - [Net Promoter Score](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/net-promoter-score.md): 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. - [Ranking](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/ranking.md): 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. - [Rating](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/rating.md): Rating questions allow respondents to rate questions on a scale - [Schedule A Meeting](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/schedule-a-meeting.md): 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. - [Multi Select](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/select-multiple.md): Multi select questions allow respondents to select several answers from a list - [Picture Selection](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/select-picture.md): Picture selection questions allow respondents to select one or more images from a list - [Single Select](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/select-single.md): Single select questions allow respondents to select one answer from a list - [Statement (Call to Action)](https://formbricks.com/docs/xm-and-surveys/surveys/question-type/statement-cta.md): The Statement question type allows you to display descriptive information in your survey, such as a message or instruction. - [Actions](https://formbricks.com/docs/xm-and-surveys/surveys/website-app-surveys/actions.md): Actions are predefined events within your app that prompt Formbricks to display a survey when triggered. These are detected by the Formbricks widget, which then presents the appropriate survey based on your predefined settings. - [Advanced Targeting](https://formbricks.com/docs/xm-and-surveys/surveys/website-app-surveys/advanced-targeting.md): Advanced Targeting allows you to show surveys to a specific segment of your users. You can target surveys based on user attributes, device type, and more. This helps you get more relevant insights while keeping survey fatigue at a minimum. After the initial setup, you can target any segment without… - [Framework Guides](https://formbricks.com/docs/xm-and-surveys/surveys/website-app-surveys/framework-guides.md): Easily add the Formbricks App Survey SDK to your app with guides for different frameworks. - [Google Tag Manager](https://formbricks.com/docs/xm-and-surveys/surveys/website-app-surveys/google-tag-manager.md): Deploy Formbricks surveys through GTM without modifying your website code. - [Quickstart - Web & App Surveys](https://formbricks.com/docs/xm-and-surveys/surveys/website-app-surveys/quickstart.md): App surveys deliver 6–10x higher conversion rates compared to email surveys. If you are new to Formbricks, follow the steps in this guide to launch a survey in your web or mobile app (React Native) within 10–15 minutes. - [Recontact Options](https://formbricks.com/docs/xm-and-surveys/surveys/website-app-surveys/recontact.md): Recontact options in Formbricks enable you to manage how often and under what conditions a survey is shown to a user. This feature is crucial for balancing effective feedback collection with a positive user experience by preventing survey fatigue. - [Survey % of Users](https://formbricks.com/docs/xm-and-surveys/surveys/website-app-surveys/show-survey-to-percent-of-users.md): Formbricks allows you to display surveys to only a percentage of your targeted users. This is helpful for surveying on public facing website. - [User Identification](https://formbricks.com/docs/xm-and-surveys/surveys/website-app-surveys/user-identification.md): User Identification helps you to not only segment your users but also to see more information about the user who responded to a survey. This helps you to target surveys to specific user segments and see more information about the user who responded to a survey. - [Learn from Churn](https://formbricks.com/docs/xm-and-surveys/xm/best-practices/cancel-subscription.md): Mastering Churn Surveys with Formbricks | Essential Tips & Steps - [Contact form](https://formbricks.com/docs/xm-and-surveys/xm/best-practices/contact-form.md): A step-by-step guide to creating a contact form using Formbricks. - [Docs Feedback](https://formbricks.com/docs/xm-and-surveys/xm/best-practices/docs-feedback.md): A step-by-step guide to getting feedback on your Documentation with Formbricks - [Feature Chaser](https://formbricks.com/docs/xm-and-surveys/xm/best-practices/feature-chaser.md): Learn how to harness the power of Formbricks to gather targeted user feedback on specific features. Dive deep into creating, triggering, and publishing the Feature Chaser survey to enhance your product with actionable insights for specific users. - [Feedback Box](https://formbricks.com/docs/xm-and-surveys/xm/best-practices/feedback-box.md): A step-by-step guide to creating a feedback box using Formbricks. - [Headless Surveys](https://formbricks.com/docs/xm-and-surveys/xm/best-practices/headless-surveys.md): Using Formbricks as a Headless Survey Platform - [Improve Email Content](https://formbricks.com/docs/xm-and-surveys/xm/best-practices/improve-email-content.md): Measure email content quality with Formbricks - [Improve Trial Conversion](https://formbricks.com/docs/xm-and-surveys/xm/best-practices/improve-trial-cr.md): Improve Trial Conversion with Formbricks - [App Interview Prompt](https://formbricks.com/docs/xm-and-surveys/xm/best-practices/interview-prompt.md): Maximize User Interview Participation with App Interview Prompts - [Product-Market Fit](https://formbricks.com/docs/xm-and-surveys/xm/best-practices/pmf-survey.md): How to Set Up a Product-Market Fit Survey Using Formbricks - Step-by-Step Guide - [Quiz Time](https://formbricks.com/docs/xm-and-surveys/xm/best-practices/quiz-time.md): How to Create a Quiz Using Formbricks - Step-by-Step Guide - [Panel Management](https://formbricks.com/docs/xm-and-surveys/xm/best-practices/research-panel.md): Build and manage your own research panel using Formbricks to collect profiling data, create targeted segments, and distribute personalized survey links to panel members. - [Understanding Formbricks Survey Types](https://formbricks.com/docs/xm-and-surveys/xm/best-practices/understanding-survey-types.md): This guide explains the differences between Formbricks Link Surveys and Website & App Surveys to help you choose the right option. ## OpenAPI Specs - [openapi](https://formbricks.com/docs/api-v3-reference/openapi.yml)