You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 7-8.RSVP
Socket
Socket
Sign inDemoInstall

@formbricks/api

Package Overview
Dependencies
Maintainers
1
Versions
7
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

@formbricks/api

Formbricks-api is an api wrapper for the Formbricks client API


Version published
Weekly downloads
1.2K
increased by7.68%
Maintainers
1
Created
Weekly downloads
 

Readme

Source

@formbricks/api - API Wrapper for Formbricks

This is the official API wrapper for Formbricks. It is used to interact with the Formbricks API. To know more about Formbricks, visit Formbricks.com.

The direct API documentation can be found in our official docs here. To interact with the Formbricks API, you need to have an environment ID. You can get it from the Formbricks dashboard at app.formbricks.com.

Installation

npm install @formbricks/api

Usage

Init

import { FormbricksAPI } from "@formbricks/api";

const api = new FormbricksAPI({
  apiHost: `https://app.formbricks.com`, // If you have self-hosted Formbricks, change this to your self hosted instance's URL
  environmentId: "<environment-id>", // Replace this with your Formbricks environment ID
});

The API client is now ready to be used across your project. It can be used to interact with the following models:

Display

  • Create a Display

    await api.client.display.create({
      surveyId: "<your-survey-id>", // required
      userId: "<your-user-id>", // optional
      responseId: "<your-response-id>", // optional
    });
    
  • Update a Display

    await api.client.display.update(
      displayId: "<your-display-id>",
      {
        userId: "<your-user-id>", // optional
        responseId: "<your-response-id>", // optional
      },
    );
    

Response

  • Create a Response

    await api.client.response.create({
      surveyId: "<your-survey-id>", // required
      finished: boolean, // required
      data: {
        questionId: "<answer-to-this-question-in-string>",
        anotherQuestionId: 123, // answer to this question in number
        yetAnotherQuestionId: ["option1", "option2"], // answer to this question in array,
      }, // required
    
      userId: "<your-user-id>", // optional
      singleUseId: "<your-single-use-id>", // optional
      ttc: {
        questionId: 123, // optional
      }, // optional
      meta: {
        source: "<your-source>", // optional
        url: "<your-url>", // optional
        userAgent: {
          browser: "<your-browser>", // optional
          device: "<your-device>", // optional
          os: "<your-os>", // optional
        },
        country: "<your-country>", // optional
      }, // optional
    });
    
  • Update a Response

    await api.client.response.update({
      responseId: "<your-response-id>", // required
      finished: boolean, // required
      data: {
        questionId: "<answer-to-this-question-in-string>",
        anotherQuestionId: 123, // answer to this question in number
        yetAnotherQuestionId: ["option1", "option2"], // answer to this question in array,
      }, // required
      ttc: {
        questionId: 123, // optional
      }, // optional
    });
    

Action

  • Create an Action

    await api.client.action.create({
      name: "<your-action-name>", // required
      properties: {
        key1: "value1",
        key2: "value2",
        key3AsNumber: 123,
      }, // required
    
      personId: "<your-person-id>", // optional
      sessionId: "<your-session-id>", // optional
    });
    

People

  • Create a Person

    await api.client.people.create({
      userId: "<your-user-id>", // required
    });
    
  • Update a Person

    await api.client.people.update(personId: "<your-person-id>", // required
    {
      attributes: {
        key1: "value1",
        key2: "value2",
        key3AsNumber: 456,
      }, // required
    }
    

Storage

  • Upload a file

    await api.client.storage.uploadFile(
      file: File, // required (of interface File of the browser's File API)
      {
        allowedFileTypes: ["file-type-allowed", "for-example", "image/jpeg"], // optional
        surveyId: "<your-survey-id>", // optional
    
      } // optional
    );
    

If you have any questions or need help, feel free to reach out to us on our Discord

Keywords

FAQs

Package last updated on 19 Mar 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc