Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to RepairShopr

Scalekit connector
Open markdown

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

Tools
60
What they doRead · write · destructive
30 · 25 · 530 read25 write5 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 RepairShopr connection

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

    Each user opens the link once and enters their RepairShopr 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
  • repairshopr_appointment_getGet one RepairShopr appointment.Read-only

    Get Appointment

    Get one RepairShopr appointment. Returns the appointment's summary, times, location, customer, ticket and users. Use this for an appointment's details.

    Inputs

    idintegerrequired
    ID of the appointment, from repairshopr_appointments_list. Example: 1001.
  • repairshopr_appointments_listList RepairShopr appointments.Read-only

    List Appointments

    List RepairShopr appointments. Returns appointments with ID, summary, start and end times, customer, ticket and users. Use this to see the schedule.

    Inputs

    date_fromstring
    Returns Appointments that start after the date. Example "2019-01-25". Example: 2026-11-01.
    date_tostring
    Returns Appointments that start before the date. Example "2019-12-31". Example: 2026-11-30.
    mineboolean
    Return only current user's appointments. Example: true.
    pageinteger
    Returns provided page of results, each 'page' contains 25 results. Example: 1.
  • repairshopr_asset_getGet one RepairShopr customer asset.Read-only

    Get Asset

    Get one RepairShopr customer asset. Returns the asset's name, type, serial, properties and customer. Use this for a device's details.

    Inputs

    idintegerrequired
    ID of the asset, from repairshopr_assets_list. Example: 1001.
  • repairshopr_assets_listList RepairShopr customer assets (devices), 25 per page.Read-only

    List Assets

    List RepairShopr customer assets (devices), 25 per page. Returns assets with ID, name, type, serial and customer. Use this to find a customer's devices.

    Inputs

    asset_type_idinteger
    Any assets attached to an Asset Type ID. Example: 8.
    customer_idinteger
    Any assets attached to a Customer ID. Example: 2001.
    pageinteger
    Returns provided page of results, each 'page' contains 25 results. Example: 1.
    querystring
    Search query. Example: smith.
    snmp_enabledboolean
    Any assets with SNMP enabled. Example: true.
    sortstring
    An asset field to order by. Examples "name ASC", "name DESC". Example: lastname ASC.
  • repairshopr_contact_getGet one RepairShopr contact.Read-only

    Get Contact

    Get one RepairShopr contact. Returns the contact's name, email, phone, address and customer. Use this for a contact's details.

    Inputs

    idintegerrequired
    ID of the contact, from repairshopr_contacts_list. Example: 1001.
  • repairshopr_contacts_listList RepairShopr contacts (people at business customers), optionally for one customer.Read-only

    List Contacts

    List RepairShopr contacts (people at business customers), optionally for one customer. Returns contacts with ID, name, email, phone and customer. Use this to find a contact.

    Inputs

    customer_idinteger
    Any contacts attached to a Customer ID. Example: 2001.
    pageinteger
    Returns provided page of results, each 'page' contains 25 results. Example: 1.
  • repairshopr_customer_getGet one RepairShopr customer.Read-only

    Get Customer

    Get one RepairShopr customer. Returns the customer with contact details, address, contacts and custom properties. Use this for a customer's details.

    Inputs

    idintegerrequired
    ID of the customer, from repairshopr_customers_list. Example: 1001.
  • repairshopr_customers_listList RepairShopr customers, filtered by name, business name, email or a search query, 25 per page.Read-only

    List Customers

    List RepairShopr customers, filtered by name, business name, email or a search query, 25 per page. Returns customers with ID, names, contact details and address, plus paging meta. Use this to find a customer. Use repairshopr_customer_get for one customer.

    Inputs

    business_namestring
    Any customers with a business name like the parameter. Example: Acme Repairs.
    emailstring
    Email. Example: jane@example.com.
    firstnamestring
    Any customers with a first name like the parameter. Example: Jane.
    idinteger
    Customers with this ID. Example: 1001.
    id_notinteger
    Customers with any ID other than this. Example: 1000.
    include_disabledstring
    Whether or not the returned list of customers includes disabled customers. Defaults to false. Example: false.
    lastnamestring
    Any customers with a last name like the parameter. Example: Doe.
    pageinteger
    Returns provided page of results, each 'page' contains 25 results. Example: 1.
    querystring
    Search query. Example: smith.
    sortstring
    A customer field to order by. Examples "firstname ASC", "city DESC". Example: lastname ASC.