API

API Overview

Formbricks offers two types of APIs: the Public Client API and the Management API. Each API serves a different purpose, has different authentication requirements, and provides access to different data and settings.

View our API Documentation in more than 30 frameworks and languages.

Public Client API

The Public Client API is designed for our SDKs and does not require authentication. This API is ideal for client-side interactions, as it doesn't expose sensitive information.

We currently have the following Client API methods exposed and below is their documentation attached in Postman:

• Displays API - Mark Survey as Displayed or Update an existing Display by linking it with a Response for a Person
• People API - Create & Update a Person (e.g. attributes, email, userId, etc)
• Responses API - Create & Update a Response for a Survey

Management API

The Management API provides access to all data and settings that your account has access to in the Formbricks app. This API requires a personal API Key for authentication, which can be generated in the Settings section of the Formbricks app. Checkout the API Key Setup below to generate & manage API Keys.

We currently have the following Management API methods exposed and below is their documentation attached in Postman:

• Action Class API - Create, List, and Delete Action Classes
• Attribute Class API - Create, List, and Delete Attribute Classes
• Me API - Retrieve Account Information
• People API - List and Delete People
• Response API - List, List by Survey, Update, and Delete Responses
• Survey API - List, Create, Update, generate multiple suId and Delete Surveys
• Webhook API - List, Create, and Delete Webhooks

How to Generate an API key

The API requests are authorized with a personal API key. This API key gives you the same rights as if you were logged in at formbricks.com - don't share it around!

1. Go to your settings on app.formbricks.com.
2. Go to page “API keys”
3. Create a key for the development or production environment.
4. Copy the key immediately. You won’t be able to see it again.

Test your API Key

Hit the below request to verify that you are authenticated with your API Key and the server is responding.

Get My Profile

curl --location \
'https://app.formbricks.com/api/v1/me' \
--header \
'x-api-key: <your-api-key>'

{
  "id": "cll2m30r70004mx0huqkitgqv",
  "createdAt": "2023-08-08T18:04:59.922Z",
  "updatedAt": "2023-08-08T18:04:59.922Z",
  "type": "production",
  "project": {
      "id": "cll2m30r60003mx0hnemjfckr",
      "name": "My Project"
  },
  "appSetupCompleted": false,
  "websiteSetupCompleted": false,
}

Can’t figure it out?: Get help in Github Discussions