Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Salesflare

Scalekit connector
Open markdown

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

Tools
59
What they doRead · write · destructive
31 · 20 · 831 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 Salesflare connection

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

    Each user opens the link once and enters their Salesflare 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
  • salesflare_account_feed_getGet the activity timeline of an account: emails, internal notes, meetings, calls, web visits and team changes, optionally filtered by type, contacts or date.Read-only

    Get Account Feed

    Get the activity timeline of an account: emails, internal notes, meetings, calls, web visits and team changes, optionally filtered by type, contacts or date. Returns feed items with type, date, participants and content. Use this for a full history. Use salesflare_account_messages_list for emails only.

    Inputs

    account_idintegerrequired
    Salesflare ID of the account. Example: 45678.
    afterstring
    Only items after this ISO 8601 date-time. Defaults to 1970-01-01T00:00:00.000Z. Example: 2026-01-01T00:00:00Z.
    beforestring
    Only items before this ISO 8601 date-time. Example: 2026-06-30T23:59:59Z.
    contactsarray
    Contact IDs to filter the feed on; leave empty for all contacts. Example: [56789]
    limitinteger
    Maximum number of records to return. Defaults to 10. Example: 25.
    typesarray
    Feed item types to include. Example: ["email","meeting-live"]
  • salesflare_account_getGet one account by ID.Read-only

    Get Account

    Get one account by ID. Returns its name, domain, size, description, addresses, email addresses, phone numbers, social profiles, tags, owner, team and custom fields. Use this when you know the account ID. Use salesflare_accounts_list to find it.

    Inputs

    account_idintegerrequired
    Salesflare ID of the account. Example: 45678.
  • salesflare_account_messages_listList the email messages exchanged with an account, optionally within a date range.Read-only

    List Account Messages

    List the email messages exchanged with an account, optionally within a date range. Returns message ID, subject, body preview, sender, recipients and date. Use this to read correspondence. Use salesflare_account_feed_get for all activity types.

    Inputs

    account_idintegerrequired
    Salesflare ID of the account. Example: 45678.
    afterstring
    Only items after this ISO 8601 date-time. Defaults to 1970-01-01T00:00:00.000Z. Example: 2026-01-01T00:00:00Z.
    beforestring
    Only items before this ISO 8601 date-time. Example: 2026-06-30T23:59:59Z.
    limitinteger
    Maximum number of records to return. Defaults to 10. Example: 25.
  • salesflare_accounts_listList accounts (companies), filtered by name, search text, domain, size, tag, address, hotness or creation date.Read-only

    List Accounts

    List accounts (companies), filtered by name, search text, domain, size, tag, address, hotness or creation date. Returns account ID, name, domain, size, hotness, owner and last interaction; set details to true for addresses, phones and custom fields. Use this to find accounts. Use salesflare_account_get for one account by ID.

    Inputs

    address_cityarray
    Filter by address city. Example: Ghent.
    address_countryarray
    Filter by address country. Example: Belgium.
    address_state_regionarray
    Filter by address state or region. Example: East Flanders.
    creation_afterstring
    Only records created after this ISO 8601 date-time. Example: 2026-01-01T00:00:00Z.
    creation_beforestring
    Only records created before this ISO 8601 date-time. Example: 2026-06-30T23:59:59Z.
    detailsboolean
    Set to true to include full details (addresses, phone numbers, social profiles and custom fields) for each record. Defaults to true. Example: true.
    domainarray
    Filter by website domain, without protocol. Example: acme.com.
    hotnessinteger
    Hotness level: 1 (room temperature), 2 (hot) or 3 (on fire). One of: 1, 2, 3. Example: 2.
    idinteger
    Return only the record with this Salesflare ID. Example: 12345.
    limitinteger
    Maximum number of records to return. Defaults to 10. Example: 25.
    max_sizeinteger
    Only accounts with at most this many employees. Example: 500.
    min_sizeinteger
    Only accounts with at least this many employees. Example: 10.
    namestring
    Filter by name (exact or partial match). Example: Acme.
    offsetinteger
    Number of records to skip, for paging. Example: 0.
    order_byarray
    Sort field; add ' desc' for descending order, e.g. 'creation_date desc'. Example: creation_date desc.
    searchstring
    Free-text search across names, email addresses and domains. Example: acme.
    taginteger
    Filter by tag ID. Example: 321.
    tag_namearray
    Filter by tag name. Example: enterprise.
  • salesflare_contact_getGet one contact by ID.Read-only

    Get Contact

    Get one contact by ID. Returns name, emails, phone numbers, positions, addresses, account, owner, tags, social profiles and custom fields. Use this when you know the contact ID.

    Inputs

    contact_idintegerrequired
    Salesflare ID of the contact. Example: 56789.
  • salesflare_contacts_listList contacts, filtered by name, email, phone, domain, account, tag, role, address, type or creation and change dates.Read-only

    List Contacts

    List contacts, filtered by name, email, phone, domain, account, tag, role, address, type or creation and change dates. Returns contact ID, name, email, phone, account, position and tags. Use this to find contacts. Use salesflare_contact_get for one contact. Use salesflare_my_contacts_list for only your own contacts.

    Inputs

    accountinteger
    Filter by the Salesflare account ID the record is linked to. Example: 45678.
    address_cityarray
    Filter by address city. Example: Ghent.
    address_countryarray
    Filter by address country. Example: Belgium.
    address_state_regionarray
    Filter by address state or region. Example: East Flanders.
    creation_afterstring
    Only records created after this ISO 8601 date-time. Example: 2026-01-01T00:00:00Z.
    creation_beforestring
    Only records created before this ISO 8601 date-time. Example: 2026-06-30T23:59:59Z.
    domainstring
    Filter by website domain, without protocol. Example: acme.com.
    emailstring
    Filter by email address. Example: jane@acme.com.
    idinteger
    Return only the record with this Salesflare ID. Example: 12345.
    include_archivedboolean
    Set to true to include archived contacts. Example: false.
    limitinteger
    Maximum number of records to return. Defaults to 20. Example: 25.
    modification_afterstring
    Only records changed after this ISO 8601 date-time. Example: 2026-01-01T00:00:00Z.
    modification_beforestring
    Only records changed before this ISO 8601 date-time. Example: 2026-06-30T23:59:59Z.
    namestring
    Filter by name (exact or partial match). Example: Acme.
    offsetinteger
    Number of records to skip, for paging. Defaults to 0. Example: 0.
    order_byarray
    Sort field; add ' desc' for descending order, e.g. 'creation_date desc'. Example: creation_date desc.
    phone_numberstring
    Filter by phone number. Example: +32 9 123 45 67.
    position_rolearray
    Filter by the contact's job role. Example: CTO.
    searchstring
    Free-text search across names, email addresses and domains. Example: acme.
    taginteger
    Filter by tag ID. Example: 321.
    tag_namearray
    Filter by tag name. Example: enterprise.
    typestring
    customer for contacts linked to an account, mycontacts for your own contacts. One of: customer, mycontacts. Example: customer.one of customermycontacts
  • salesflare_currencies_listList the currencies Salesflare supports.Read-only

    List Currencies

    List the currencies Salesflare supports. Returns currency ID, ISO code and symbol. Use this to find a currency ID for opportunities.

    Inputs

    This tool takes no inputs.

  • salesflare_custom_field_getGet one custom field by ID.Read-only

    Get Custom Field

    Get one custom field by ID. Returns its name, API field name, type, options and settings. Use this when you know the field ID.

    Inputs

    idintegerrequired
    ID of the custom field. Example: 2201.
    item_classstringrequired
    Record type the custom field belongs to: accounts, contacts or opportunities. Example: accounts.one of accountscontactsopportunities