Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Fireberry

Scalekit connector
Open markdown

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

Tools
60
What they doRead · write · destructive
32 · 20 · 832 read20 write8 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 Fireberry connection

    In AgentKit > Connections, create a Fireberry 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 = 'fireberry'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Fireberry:', 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: 'fireberry_accounts_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Fireberry 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
  • fireberry_account_getGet one account by GUID.Read-only

    Get Account

    Get one account by GUID. Returns data with all of the record's fields. Use fireberry_account_get when you have the GUID.

    Inputs

    idstringrequired
    GUID of the account. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
  • fireberry_accounts_listList accounts (object 1) a page at a time, up to 50 per page and 10 pages.Read-only

    List Accounts

    List accounts (object 1) a page at a time, up to 50 per page and 10 pages. Returns data with Records[], Total_Records, Page_Size and Page_Number. Use fireberry_accounts_list to browse. Use fireberry_records_query to filter or sort.

    Inputs

    page_numberinteger
    Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
    page_sizeinteger
    Records per page, up to 50. Defaults to 50. Example: 50.
  • fireberry_articles_listList knowledge base articles (object 76) a page at a time.Read-only

    List Articles

    List knowledge base articles (object 76) a page at a time. Returns data with Records[] and paging info. Use fireberry_articles_list to find help content for tickets.

    Inputs

    page_numberinteger
    Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
    page_sizeinteger
    Records per page, up to 50. Defaults to 50. Example: 50.
  • fireberry_campaigns_listList marketing campaigns (object 67) a page at a time.Read-only

    List Campaigns

    List marketing campaigns (object 67) a page at a time. Returns data with Records[] and paging info. Use fireberry_campaigns_list to get campaign GUIDs for accounts and contacts.

    Inputs

    page_numberinteger
    Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
    page_sizeinteger
    Records per page, up to 50. Defaults to 50. Example: 50.
  • fireberry_contact_getGet one contact by GUID.Read-only

    Get Contact

    Get one contact by GUID. Returns data with all of the record's fields. Use fireberry_contact_get when you have the GUID.

    Inputs

    idstringrequired
    GUID of the contact. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
  • fireberry_contacts_listList contacts (object 2) a page at a time, up to 50 per page and 10 pages.Read-only

    List Contacts

    List contacts (object 2) a page at a time, up to 50 per page and 10 pages. Returns data with Records[], Total_Records, Page_Size and Page_Number. Use fireberry_contacts_list to browse. Use fireberry_records_query to filter or sort.

    Inputs

    page_numberinteger
    Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
    page_sizeinteger
    Records per page, up to 50. Defaults to 50. Example: 50.
  • fireberry_field_getGet one field's details.Read-only

    Get Field

    Get one field's details. Returns data with the field's label, type and settings. Use fireberry_field_get to check a field's type.

    Inputs

    fieldnamestringrequired
    System name of the field. Example: accounttypecode.
    idintegerrequired
    Object number. Example: 1.
  • fireberry_invoice_items_listList the line items of an invoice.Read-only

    List Invoice Items

    List the line items of an invoice. Returns data with each item's product, quantity and price. Use fireberry_invoice_items_list after fireberry_invoices_list.

    Inputs

    idstringrequired
    GUID of the invoice. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.