Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Dynamo Software

Scalekit connector
Open markdown

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

Tools
36
What they doRead · write · destructive
21 · 12 · 321 read12 write3 destructive
Users sign in with

What you can do

  • Read entity data: list, look up, and count items in any Dynamo entity with filters and sorting
  • Create and update items: add or update single items, or create, update, and delete many at once
  • Manage documents: upload, version, update, and delete documents and check upload restrictions
  • Query views and saved searches: pull data from Dynamo views, SQL views, and saved search criteria
  • Trigger workflows: run workflow action buttons, custom operations, and scheduled workflows on demand
  • Explore schemas: list entities and inspect their properties and schema definitions

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 Dynamo Software connection

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

    Each user opens the link once and enters their Dynamo Software 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
  • dynamo_decrypt_propertyReturns decrypted value of an encrypted property for a given entity record.Read-only

    Decrypt Entity Property

    Returns decrypted value of an encrypted property for a given entity record.

    Inputs

    entityNamestringrequired
    The name of the Dynamo entity that contains the encrypted property (e.g., 'Contact', 'Activity').
    idstringrequired
    The unique identifier (UUID/entity key) of the specific entity record whose encrypted property you want to decrypt.
    propertystringrequired
    The name of the encrypted property to decrypt. Must be a property that is configured as encrypted in Dynamo.
  • dynamo_entity_by_idReturns a single instance of a Dynamo entity by its ID with optional column selection and formatting controls.Read-only

    Get Entity By ID

    Returns a single instance of a Dynamo entity by its ID with optional column selection and formatting controls.

    Inputs

    entityNamestringrequired
    The name of the Dynamo entity type to retrieve a record from (e.g., 'activity', 'contact').
    idstringrequired
    The unique identifier (UUID) of the specific entity record to retrieve.
    x_columnsstring
    Comma-separated list of property names to include in the response. Reduces bandwidth by returning only specified fields.
    x_columns_encodedboolean
    When true, the x_columns value must be provided as a base64-encoded string. Default is false.
    x_resolvedboolean
    When false, reference/lookup properties are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.
    x_showlabelsboolean
    When true, property keys in the response use display labels instead of internal property names. Default is false.
  • dynamo_entity_extended_schemaReturns the extended schema definition of a specified Dynamo entity, including detailed metadata and optional permissions.Read-only

    Get Extended Entity Schema

    Returns the extended schema definition of a specified Dynamo entity, including detailed metadata and optional permissions.

    Inputs

    entityNamestringrequired
    The name of the Dynamo entity to retrieve the extended schema for (e.g., 'activity', 'contact', 'document').
    permissionsboolean
    When true, the schema response includes information about the current user's permissions to perform operations on each property. Default is false.
  • dynamo_entity_propertiesReturns all properties for a specified Dynamo entity.Read-only

    Get Entity Properties

    Returns all properties for a specified Dynamo entity.

    Inputs

    entityNamestringrequired
    The name of the Dynamo entity whose properties (field list) you want to retrieve.
  • dynamo_entity_schemaReturns the schema definition of a specified Dynamo entity.Read-only

    Get Entity Schema

    Returns the schema definition of a specified Dynamo entity.

    Inputs

    entityNamestringrequired
    The name of the Dynamo entity whose field schema you want to retrieve (e.g., 'activity', 'contact', 'document').
    permissionsboolean
    When true, the schema response includes information about the current user's permissions to perform operations on each property. Default is false.
  • dynamo_entity_totalReturns total count of items for a given Dynamo entity.Read-only

    Get Entity Total Count

    Returns total count of items for a given Dynamo entity.

    Inputs

    entityNamestringrequired
    The name of the Dynamo entity whose total record count you want to retrieve.
  • dynamo_get_document_by_idReturns a single Dynamo document by its unique ID with optional column filtering and formatting controls.Read-only

    Get Document By ID

    Returns a single Dynamo document by its unique ID with optional column filtering and formatting controls.

    Inputs

    idstringrequired
    The unique identifier (UUID) of the document to retrieve.
    x_columnsstring
    Comma-separated list of property names to include in the response. Reduces bandwidth.
    x_columns_encodedboolean
    When true, the x_columns value must be provided as a base64-encoded string. Default is false.default false
    x_identifierboolean
    When true, the response includes the Identifier property (Name (ID)) for the document. Default is true.
    x_resolvedboolean
    When false, reference/lookup properties are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.default true
    x_showlabelsboolean
    When true, property keys in the response use display labels instead of internal property names. Default is false.
  • dynamo_get_document_extended_schemaReturns an extended schema of the Dynamo Document entity, including detailed metadata and optional permission information.Read-only

    Get Document Extended Schema

    Returns an extended schema of the Dynamo Document entity, including detailed metadata and optional permission information.

    Inputs

    permissionsboolean
    When true, the extended schema response includes information about the current user's permissions to perform operations on each property. Default is false.