Skip to main content

Documentation Index

Fetch the complete documentation index at: https://formbricks.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

A Source defines how external data is mapped into Feedback Records inside a Feedback Directory. Manage them from Unify → Sources.

​
Source types

Formbricks supports three source types:

​
1. Formbricks Surveys

Pipe responses from a Formbricks survey directly into a Feedback Directory. Pick a survey, select the questions you want to ingest - that’s it. Formbricks automatically maps each question to its field_type. Optionally create Feedback Records of existing responses on connect.

​
2. CSV Import

Upload a CSV (up to 2 MB and 1,000 rows) and Formbricks auto-suggests a column mapping based on common header names (timestamp, response_id, rating, feedback_text, …). Required columns: submission_id, field_id, field_type, and the feedback value.
Re-uploading a CSV with the same submission_id updates existing records instead of creating duplicates.
A sample CSV is available from the source creation dialog.

​
3. API Ingestion

Push records into a directory programmatically from your own systems. Best for server-to-server ingestion. API reference docs are coming soon.

​
Field mapping

For CSV and API sources, you map each source column or question to a Feedback Record field. CSV mapping suggests matches automatically with high/medium/low confidence based on header names. For Formbricks Surveys, we handle the mapping internally - each question type is translated into the matching Hub field_type:
  • Single-select, multi-select, dropdown → categorical
  • NPS → nps
  • Rating → rating
  • CSAT → csat
  • CES → ces
  • Free text → text
  • Number → number
  • Date → date
  • Boolean / consent → boolean

​
Managing sources

From the Sources page you can:
  • Create a new source for any source type.
  • Edit the mapping for an existing source.
  • Pause or resume ingestion.
  • Delete a source. Existing records stay in the directory.