Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Rentman

Scalekit connector
Open markdown

The Rentman connector lets your AI agent act in each user's Rentman account. Each user connects their own Rentman 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
36 · 19 · 536 read19 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 Rentman connection

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

    Each user opens the link once and enters their Rentman 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
  • rentman_appointment_getGet one appointment by ID.Read-only

    Get Appointment

    Get one appointment by ID. Returns data with name, start, end, location, remark and crew. Use rentman_appointment_get when you have the ID.

    Inputs

    appointment_idintegerrequired
    Numeric ID of the appointment. Example: 4321.
    expandstring
    Comma-separated linked fields to inline as objects instead of paths, dot notation for nesting. Example: account_manager.
    fieldsstring
    Comma-separated fields to return (id, created and modified are always returned). Example: id,displayname,name.
  • rentman_appointments_listList appointments (agenda items not tied to projects).Read-only

    List Appointments

    List appointments (agenda items not tied to projects). Returns data[] of appointments with name, start, end, location, remark and is_plannable, plus itemCount, limit and next_page_url. Use rentman_appointments_list to read the agenda.

    Inputs

    cursorstring
    Paging cursor taken from the cursor parameter of the previous response's next_page_url. Example: eyJhZnRlciI6NDU2LCJvcmRlciI6ImRlc2MiLCJsaW1pdCI6MTB9.
    expandstring
    Comma-separated linked fields to inline as objects instead of paths, dot notation for nesting. Example: account_manager.
    fieldsstring
    Comma-separated fields to return (id, created and modified are always returned). Example: id,displayname,name.
    limitinteger
    Items per page, up to 1500. Defaults to 300. Example: 100.
    sortstring
    Comma-separated fields to sort by, each prefixed with + (ascending) or - (descending). Example: -modified.
  • rentman_contact_getGet one contact by ID.Read-only

    Get Contact

    Get one contact by ID. Returns data with name, type, code, addresses, emails, phones, VAT and discounts. Use rentman_contact_get when you have the ID.

    Inputs

    contact_idintegerrequired
    Numeric ID of the contact. Example: 4321.
    expandstring
    Comma-separated linked fields to inline as objects instead of paths, dot notation for nesting. Example: account_manager.
    fieldsstring
    Comma-separated fields to return (id, created and modified are always returned). Example: id,displayname,name.
  • rentman_contact_person_getGet one contact person by ID.Read-only

    Get Contact Person

    Get one contact person by ID. Returns data with name, function, contact, email and phones. Use rentman_contact_person_get when you have the ID.

    Inputs

    contact_person_idintegerrequired
    Numeric ID of the contact person. Example: 4321.
    expandstring
    Comma-separated linked fields to inline as objects instead of paths, dot notation for nesting. Example: account_manager.
    fieldsstring
    Comma-separated fields to return (id, created and modified are always returned). Example: id,displayname,name.
  • rentman_contact_persons_listList the contact persons of a contact.Read-only

    List Contact Persons

    List the contact persons of a contact. Returns data[] of people with firstname, lastname, function, email, phone and mobilephone, plus itemCount, limit and next_page_url. Use rentman_contact_persons_list for the people at a customer.

    Inputs

    contact_idintegerrequired
    Numeric ID of the contact. Example: 4321.
    cursorstring
    Paging cursor taken from the cursor parameter of the previous response's next_page_url. Example: eyJhZnRlciI6NDU2LCJvcmRlciI6ImRlc2MiLCJsaW1pdCI6MTB9.
    expandstring
    Comma-separated linked fields to inline as objects instead of paths, dot notation for nesting. Example: account_manager.
    fieldsstring
    Comma-separated fields to return (id, created and modified are always returned). Example: id,displayname,name.
    limitinteger
    Items per page, up to 1500. Defaults to 300. Example: 100.
    sortstring
    Comma-separated fields to sort by, each prefixed with + (ascending) or - (descending). Example: -modified.
  • rentman_contacts_listList contacts (companies and private persons).Read-only

    List Contacts

    List contacts (companies and private persons). Returns data[] of contacts with id, displayname, type, code, email_1, phone_1 and addresses, plus itemCount, limit and next_page_url. Use rentman_contacts_list to find a customer or supplier.

    Inputs

    cursorstring
    Paging cursor taken from the cursor parameter of the previous response's next_page_url. Example: eyJhZnRlciI6NDU2LCJvcmRlciI6ImRlc2MiLCJsaW1pdCI6MTB9.
    expandstring
    Comma-separated linked fields to inline as objects instead of paths, dot notation for nesting. Example: account_manager.
    fieldsstring
    Comma-separated fields to return (id, created and modified are always returned). Example: id,displayname,name.
    limitinteger
    Items per page, up to 1500. Defaults to 300. Example: 100.
    sortstring
    Comma-separated fields to sort by, each prefixed with + (ascending) or - (descending). Example: -modified.
  • rentman_crew_appointments_listList the appointments of a crew member.Read-only

    List Crew Appointments

    List the appointments of a crew member. Returns data[] of appointments with name, start, end, location and remark, plus itemCount, limit and next_page_url. Use rentman_crew_appointments_list for a crew member's agenda.

    Inputs

    crew_idintegerrequired
    Numeric ID of the crew member. Example: 4321.
    cursorstring
    Paging cursor taken from the cursor parameter of the previous response's next_page_url. Example: eyJhZnRlciI6NDU2LCJvcmRlciI6ImRlc2MiLCJsaW1pdCI6MTB9.
    expandstring
    Comma-separated linked fields to inline as objects instead of paths, dot notation for nesting. Example: account_manager.
    fieldsstring
    Comma-separated fields to return (id, created and modified are always returned). Example: id,displayname,name.
    limitinteger
    Items per page, up to 1500. Defaults to 300. Example: 100.
    sortstring
    Comma-separated fields to sort by, each prefixed with + (ascending) or - (descending). Example: -modified.
  • rentman_crew_availability_listList the availability entries of a crew member.Read-only

    List Crew Availability

    List the availability entries of a crew member. Returns data[] of availability with start, end, status and remark, plus itemCount, limit and next_page_url. Use rentman_crew_availability_list before planning a crew member.

    Inputs

    crew_idintegerrequired
    Numeric ID of the crew member. Example: 4321.
    cursorstring
    Paging cursor taken from the cursor parameter of the previous response's next_page_url. Example: eyJhZnRlciI6NDU2LCJvcmRlciI6ImRlc2MiLCJsaW1pdCI6MTB9.
    expandstring
    Comma-separated linked fields to inline as objects instead of paths, dot notation for nesting. Example: account_manager.
    fieldsstring
    Comma-separated fields to return (id, created and modified are always returned). Example: id,displayname,name.
    limitinteger
    Items per page, up to 1500. Defaults to 300. Example: 100.
    sortstring
    Comma-separated fields to sort by, each prefixed with + (ascending) or - (descending). Example: -modified.