Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Formbricks

Scalekit connector
Open markdown

The Formbricks connector lets your AI agent act in each user's Formbricks account. Each user connects their own Formbricks API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 34 tools.

Tools
34
What they doRead · write · destructive
18 · 11 · 518 read11 write5 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Formbricks connection

    In AgentKit > Connections, create a Formbricks connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'formbricks'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Formbricks:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'formbricks_action_classes_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Formbricks credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • formbricks_action_class_getGet one action class.Read-only

    Get Action Class

    Get one action class. Get the ID from formbricks_action_classes_list.

    Inputs

    action_class_idstringrequired
    Action Class ID. Example: clz4t5u6v0004abcd7890uvwx
  • formbricks_action_classes_listList the actions (code or no-code events) that can trigger app surveys.Read-only

    List Action Classes

    List the actions (code or no-code events) that can trigger app surveys. Use formbricks_action_class_create to add one.

    Inputs

    This tool takes no inputs.

  • formbricks_contact_attribute_key_getGet one contact attribute key.Read-only

    Get Contact Attribute Key

    Get one contact attribute key. Returns id, createdAt, updatedAt, isUnique, key, name, description, type, workspaceId, environmentId. Get the ID from formbricks_contact_attribute_keys_list.

    Inputs

    idstringrequired
    The ID of the contact attribute key. Example: clz8w9x0y0005abcd1234yzab
  • formbricks_contact_attribute_keys_listList the contact attribute keys (attribute definitions) in a workspace.Read-only

    List Contact Attribute Keys

    List the contact attribute keys (attribute definitions) in a workspace. Returns data (a list of records with id, createdAt, updatedAt, isUnique, key, name, description, type, workspaceId, environmentId). Use this before formbricks_contact_create to check which keys exist.

    Inputs

    end_datestring
    End date. Example: 2026-01-31T23:59:59.000Z
    filter_date_fieldstring
    Date field to filter by. One of: createdAt, updatedAt. Example: createdAtone of createdAtupdatedAt
    limitnumber
    Number of items to return. Example: 50
    orderstring
    Sort order. One of: asc, desc. Example: descone of ascdesc
    skipnumber
    Number of items to skip. Example: 0
    sort_bystring
    Sort by field. One of: createdAt, updatedAt. Example: createdAtone of createdAtupdatedAt
    start_datestring
    Start date. Example: 2026-01-01T00:00:00.000Z
    workspace_idstring
    The Workspace ID to filter by. Example: clx9k2m3n0000abcd1234efgh
  • formbricks_contact_attributes_listList contact attribute values in the workspaces the key can access.Read-only

    List Contact Attributes

    List contact attribute values in the workspaces the key can access. Use formbricks_contact_attribute_keys_list for the attribute definitions.

    Inputs

    This tool takes no inputs.

  • formbricks_contact_getGet one contact with its attributes.Read-only

    Get Contact

    Get one contact with its attributes. Get the contact ID from formbricks_contacts_list.

    Inputs

    contact_idstringrequired
    The ID of the contact to retrieve. Example: clz7d8e9f0002abcd9012mnop
  • formbricks_contacts_listList the contacts in the workspaces the key can access.Read-only

    List Contacts

    List the contacts in the workspaces the key can access. Use formbricks_contact_get for one contact's attributes.

    Inputs

    This tool takes no inputs.

  • formbricks_me_getGet the workspaces and organization the API key can access, with its permission level per workspace.Read-only

    Get API Key Info

    Get the workspaces and organization the API key can access, with its permission level per workspace. Returns organizationId, organizationAccess, workspaces, environments. Use this first to get workspace IDs.

    Inputs

    This tool takes no inputs.