Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to noCRM

Scalekit connector
Open markdown

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

Tools
46
What they doRead · write · destructive
27 · 16 · 327 read16 write3 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 noCRM connection

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

    Each user opens the link once and enters their noCRM 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
  • nocrmio_find_prospectsFind prospects across all prospecting lists by email address or by a field value.Read-only

    Find Prospects

    Find prospects across all prospecting lists by email address or by a field value. Returns an array of prospects with id, lead_id, is_active, content and spreadsheet_id. Provide email, or provide field_key together with field_value.

    Inputs

    emailstring
    Email address held in a prospect column. Provide this or field_key with field_value. Example: albert@example.com.
    field_keystring
    Column name to search in; must be used with field_value. Example: Phone.
    field_valuestring
    Value to look for in the column named by field_key. Example: 0387123456.
  • nocrmio_get_client_folderRetrieve one client folder by ID.Read-only

    Get Client Folder

    Retrieve one client folder by ID. Returns the folder with id, name, description, is_active, user_id and extended_info (permalink, fields, user). Use nocrmio_list_client_folders to find IDs.

    Inputs

    idintegerrequired
    ID of the client folder. Example: 12.
  • nocrmio_get_leadRetrieve one lead by ID with full detail.Read-only

    Get Lead

    Retrieve one lead by ID with full detail. Returns the lead with id, title, step, step_id, status, amount, probability, currency, starred, next_action_at, reminder fields, tags, description, user_id, team_id, client_folder_id and extended_info. Use nocrmio_list_leads to find a lead ID first.

    Inputs

    idintegerrequired
    ID of the lead. Example: 8113.
  • nocrmio_get_lead_attachmentGet a temporary download link for one attachment of a lead.Read-only

    Get Lead Attachment

    Get a temporary download link for one attachment of a lead. Returns an object with a signed url that expires after about three minutes. Use nocrmio_list_lead_attachments to find the attachment ID.

    Inputs

    idintegerrequired
    ID of the attachment. Example: 422.
    lead_idintegerrequired
    ID of the lead. Example: 8113.
  • nocrmio_get_lead_business_cardGet a temporary download link for the business card image stored on a lead.Read-only

    Get Lead Business Card

    Get a temporary download link for the business card image stored on a lead. Returns an object with a signed url that expires after a few minutes. Use it only for leads created from a scanned business card.

    Inputs

    idintegerrequired
    ID of the lead. Example: 8113.
  • nocrmio_get_prospecting_listRetrieve one prospecting list with its prospect rows.Read-only

    Get Prospecting List

    Retrieve one prospecting list with its prospect rows. Returns the list with id, title, column_names, tags, user and spreadsheet_rows (id, lead_id, content, comment_count). Use nocrmio_list_prospecting_lists to find the ID.

    Inputs

    idintegerrequired
    ID of the prospecting list. Example: 112.
  • nocrmio_get_stepRetrieve one pipeline step by ID or exact name.Read-only

    Get Step

    Retrieve one pipeline step by ID or exact name. Returns the step with id, name, position, pipeline_id and the pipeline object. Use nocrmio_list_steps to see all steps.

    Inputs

    idstringrequired
    Step ID or exact step name; URL special characters are encoded automatically. Example: 1189.
  • nocrmio_get_teamRetrieve one team by ID or name with its members.Read-only

    Get Team

    Retrieve one team by ID or name with its members. Returns the team with id, name, users and timestamps; returns 403 when the Teams feature is off. Use nocrmio_list_teams to browse teams.

    Inputs

    idstringrequired
    Team ID or exact team name. Example: 5.