Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Pylon

Scalekit connector
Open markdown

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

Tools
134
What they doRead · write · destructive
58 · 53 · 2358 read53 write23 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 Pylon connection

    In AgentKit > Connections, create a Pylon 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 = 'pylon'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Pylon:', 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: 'pylon_accounts_list',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Pylon 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
  • pylon_account_getRetrieve a single Pylon account by its ID or external ID.Read-only

    Get Account

    Retrieve a single Pylon account by its ID or external ID. Returns the account's details including name, domain, custom fields, tags, and other metadata. Use this to look up an existing account before updating it or to fetch its current state.

    Inputs

    idstringrequired
    The ID or external ID of the account to fetch. Accepts either Pylon's internal account ID (UUID) or the external_id you assigned when creating the account.
  • pylon_account_relationships_listReturns the parent-child and partner-client relationships where the given account is the child or client, i.e.Read-only

    Get Account Relationships

    Returns the parent-child and partner-client relationships where the given account is the child or client, i.e. the parent and/or partner accounts related to this account.

    Inputs

    account_idstringrequired
    The ID of the child or client account whose relationships should be returned. Required.
  • pylon_accounts_listReturns a paginated list of accounts for the organization.Read-only

    List Accounts

    Returns a paginated list of accounts for the organization. Use the cursor from the previous response to fetch the next page, and limit to control page size (default 100, max 999).

    Inputs

    cursorstring
    The pagination cursor from a previous response's `cursor` / `next_cursor` field. Omit to fetch the first page.
    limitnumber
    The number of accounts to fetch per page. Defaults to 100. Must be greater than 0 and less than 1000.default 100
  • pylon_activity_types_listReturns all custom activity type definitions configured for the organization.Read-only

    List Activity Types

    Returns all custom activity type definitions configured for the organization. Use this to discover which activity type slugs are valid before creating a new activity on an account. Rate limit: 10 requests per minute.

    Inputs

    This tool takes no inputs.

  • pylon_audit_logs_listReturns a paginated list of audit log entries for the organization.Read-only

    List Audit Logs

    Returns a paginated list of audit log entries for the organization. Use the cursor from the response to fetch subsequent pages. Rate limit: 60 requests per minute.

    Inputs

    cursorstring
    The cursor to use for pagination.
    limitinteger
    The number of audit logs to fetch. Defaults to 100. Must be greater than 0 and less than 1000.
  • pylon_call_recording_getRetrieve a single Pylon call recording by its ID.Read-only

    Get Call Recording

    Retrieve a single Pylon call recording by its ID. Returns the call recording's details including associated account, custom fields, and other metadata.

    Inputs

    idstringrequired
    The Pylon ID of the call recording to fetch. This is the internal UUID assigned by Pylon when the call recording was created.

Related: other Customer Support connectors

All 16 in Customer Support