Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Simla.com

Scalekit connector
Open markdown

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

Tools
55
What they doRead · write · destructive
41 · 13 · 141 read13 write1 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 Simla.com connection

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

    Each user opens the link once and enters their Simla.com 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
  • simla_corporate_customer_getGet one Simla corporate customer by external ID (or internal ID with by=id).Read-only

    Get Corporate Customer

    Get one Simla corporate customer by external ID (or internal ID with by=id). Returns the corporate customer with companies, contact persons, addresses and manager. Use this for a company's details.

    Inputs

    external_idstringrequired
    Customer ID. Example: ext-1001.
    bystring
    Is specified what is transmitted in parameter externalId: internal (by=id) or external (by=externalId) ID. By default it is externalId. Example: externalId.one of idexternalId
    sitestring
    Symbolic code of store. Is specified in case of handling by externalId (by=externalId). Example: main-store.
  • simla_corporate_customers_listList Simla corporate customers (companies).Read-only

    List Corporate Customers

    List Simla corporate customers (companies). Returns corporate customers with ID, external ID, nickname, companies, contacts and manager. Use limit 20, 50 or 100 and page to move through results.

    Inputs

    filter_citystring
    City. Example: Sofia.
    filter_namestring
    Customer. Example: Jane.
    filter_regionstring
    Region. Example: Sofia City.
    limitinteger
    Quantity of elements in the answer (20 by default). Example: 20.one of 2050100
    pageinteger
    Number of page with the results (1 by default). Example: 1.
  • simla_couriers_listList the couriers configured in Simla.Read-only

    List Couriers

    List the couriers configured in Simla. Returns couriers with ID, name, phone and active flag. Use this to assign couriers to deliveries.

    Inputs

    This tool takes no inputs.

  • simla_credentials_getGet the API methods and stores the Simla API key can access.Read-only

    Get API Key Permissions

    Get the API methods and stores the Simla API key can access. Returns the allowed scopes, stores (sites) and the system version. Use this to check the connection and the key's permissions first.

    Inputs

    This tool takes no inputs.

  • simla_currencies_listList the currencies configured in Simla.Read-only

    List Currencies

    List the currencies configured in Simla. Returns currencies with code, base flag and exchange rate settings. Use this to check currencies used by stores.

    Inputs

    This tool takes no inputs.

  • simla_custom_fields_listList the custom fields defined in Simla for orders, customers and other entities.Read-only

    List Custom Fields

    List the custom fields defined in Simla for orders, customers and other entities. Returns fields with code, name, entity and type. Use this to find custom field codes for create and update calls.

    Inputs

    limitinteger
    Quantity of elements in the answer (20 by default). Example: 20.one of 2050100250
    pageinteger
    Number of page with the results (1 by default). Example: 1.
  • simla_customer_getGet one Simla customer by external ID (or internal ID with by=id).Read-only

    Get Customer

    Get one Simla customer by external ID (or internal ID with by=id). Returns the customer's full record: names, contacts, address, manager, tags, custom fields and order stats. Use this for a customer's details.

    Inputs

    external_idstringrequired
    Customer ID. Example: ext-1001.
    bystring
    Is specified what is transmitted in parameter externalId: internal (by=id) or external (by=externalId) customer ID. By default it is externalId. Example: externalId.one of idexternalId
    sitestring
    Symbolic code of store. Example: main-store.
  • simla_customer_notes_listList notes on Simla customers, filtered by text or creation date.Read-only

    List Customer Notes

    List notes on Simla customers, filtered by text or creation date. Returns notes with ID, text, customer, manager and date. Use limit 20, 50 or 100 and page to move through results.

    Inputs

    filter_created_at_fromstring
    Date/time of creation (from). Example: 2026-10-01 00:00:00.
    filter_created_at_tostring
    Date/time of creation (to). Example: 2026-10-31 23:59:59.
    filter_textstring
    Note text. Example: call back.
    limitinteger
    Quantity of elements in the answer (20 by default). Example: 20.one of 2050100
    pageinteger
    Number of page with the results (1 by default). Example: 1.