Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Elorus

Scalekit connector
Open markdown

The Elorus connector lets your AI agent act in each user's Elorus account. Each user connects their own Elorus API key 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 · 22 · 830 read22 write8 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 Elorus connection

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

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

    Get Bill

    Get one Elorus bill by ID. Returns all of the bill's fields. Use elorus_bills_list to find the ID.

    Inputs

    idstringrequired
    ID of the bill (supplier invoice). Example: 4400000040000123.
    organization_idstringrequired
    ID of the Elorus organization to act on, sent as the X-Elorus-Organization header. Find it in Elorus under Settings > Organization (the ID shown in the API section) or in the web app URL. Example: 1234567890123456.
  • elorus_bills_listList Elorus bills with search, filters, ordering and paging.Read-only

    List Bills

    List Elorus bills with search, filters, ordering and paging. Returns count, next, previous and results[] of bills. Use elorus_bill_get for one bill.

    Inputs

    organization_idstringrequired
    ID of the Elorus organization to act on, sent as the X-Elorus-Organization header. Find it in Elorus under Settings > Organization (the ID shown in the API section) or in the web app URL. Example: 1234567890123456.
    created_afterstring
    Optionally filter results from a date onwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-01.
    created_beforestring
    Optionally filter results from a date backwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-30.
    currency_codestring
    Optionally filter by currency code. Example: EUR.
    custom_idstring
    Optionally filter by custom ID. Example: ABC-123-a1.
    documenttypestring
    Optionally filter by document type ID. Example: 4400000040000123.
    draftstring
    Optionally filter by draft status. The available choices are: 1, 0.
    fpaidstring
    Optionally filter by whether the invoice is paid or not. The available choices are: yes, no. Example: 0.
    is_voidstring
    Optionally filter by void status. The available choices are: 1, 0.
    modified_afterstring
    Optionally filter results from a date onwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-01.
    modified_beforestring
    Optionally filter results from a date backwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-30.
    orderingstring
    Which field to use when ordering the results. A comma-separated list, if more than one is provided. The available fields are date, branch__branch_name, supplier__display_name, total, initial, net, draft, paid, payable, due_date, modified, created. Prepend a - to denote reverse ordering (e.g -date). Example: -created.
    overduestring
    Optionally filter by whether the invoice is overdue or not. The available choices are: yes, no. Example: 1.
    pageinteger
    A page number within the paginated result set. Example: 1.
    page_sizeinteger
    Number of results to return per page. Default is 100. The maximum allowed value is 250.
    pending_approvalstring
    Optionally filter by pending status. The available choices are: 1, 0.
    periodstring
    Optionally filter results from a date period. Date period must be one of the following constants: today,current_week, current_month, current_year, last_week, last_month, last_year or in the form of this template last_ _
    period_fromstring
    Optionally filter results from a date onwards. Must be used with the period_to parameter, otherwise it won't have any effect. Date must be in the form of YYYY-mm-dd. Example: 2026-11-01.
    period_tostring
    Optionally filter results from a date backwards. Must be used with the period_from parameter, otherwise it won't have any effect. Date must be in the form of YYYY-mm-dd. Example: 2026-11-30.
    searchstring
    A search term. Example: Acme.
    self_billedstring
    Optionally filter by whether the document is self-billed or not. Can be either 1 or 0. The available choices are: 1, 0.
    statusstring
    Optionally filter by the document's status. The available choices are: draft, pending, issued, partial, unpaid, overdue, paid, void.
    supplierstring
    Optionally filter by supplier ID. Example: 3300000040000100.
  • elorus_cash_payment_getGet one Elorus cash payment by ID.Read-only

    Get Cash Payment

    Get one Elorus cash payment by ID. Returns all of the cash payment's fields. Use elorus_cash_payments_list to find the ID.

    Inputs

    idstringrequired
    ID of the cash payment (money paid out). Example: 4400000040000123.
    organization_idstringrequired
    ID of the Elorus organization to act on, sent as the X-Elorus-Organization header. Find it in Elorus under Settings > Organization (the ID shown in the API section) or in the web app URL. Example: 1234567890123456.
  • elorus_cash_payments_listList Elorus cash payments with search, filters, ordering and paging.Read-only

    List Cash Payments

    List Elorus cash payments with search, filters, ordering and paging. Returns count, next, previous and results[] of cash payments. Use elorus_cash_payment_get for one cash payment.

    Inputs

    organization_idstringrequired
    ID of the Elorus organization to act on, sent as the X-Elorus-Organization header. Find it in Elorus under Settings > Organization (the ID shown in the API section) or in the web app URL. Example: 1234567890123456.
    contactstring
    Optionally filter by contact ID. Example: 3300000040000100.
    created_afterstring
    Optionally filter results from a date onwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-01.
    created_beforestring
    Optionally filter results from a date backwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-30.
    creditnotestring
    Optionally filter by credit note ID. Example: 1.
    currency_codestring
    Optionally filter by currency code. Example: EUR.
    custom_idstring
    Optionally filter by custom ID. Example: ABC-123-a1.
    modified_afterstring
    Optionally filter results from a date onwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-01.
    modified_beforestring
    Optionally filter results from a date backwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-30.
    orderingstring
    Which field to use when ordering the results. A comma-separated list, if more than one is provided. The available fields are date, amount, branch__branch_name, contact__display_name, modified, created. Prepend a - to denote reverse ordering (e.g -date). Example: -created.
    pageinteger
    A page number within the paginated result set. Example: 1.
    page_sizeinteger
    Number of results to return per page. Default is 100. The maximum allowed value is 250.
    periodstring
    Optionally filter results from a date period. Date period must be one of the following constants: today,current_week, current_month, current_year, last_week, last_month, last_year or in the form of this template last_ _
    period_fromstring
    Optionally filter results from a date onwards. Must be used with the period_to parameter, otherwise it won't have any effect. Date must be in the form of YYYY-mm-dd. Example: 2026-11-01.
    period_tostring
    Optionally filter results from a date backwards. Must be used with the period_from parameter, otherwise it won't have any effect. Date must be in the form of YYYY-mm-dd. Example: 2026-11-30.
    purchasestring
    Optionally filter by bill ID. Example: 1.
    searchstring
    A search term. Example: Acme.
    transaction_typestring
    Optionally filter by transaction type. Either dp, ip or cnp
  • elorus_cash_receipt_getGet one Elorus cash receipt by ID.Read-only

    Get Cash Receipt

    Get one Elorus cash receipt by ID. Returns all of the cash receipt's fields. Use elorus_cash_receipts_list to find the ID.

    Inputs

    idstringrequired
    ID of the cash receipt (money received). Example: 4400000040000123.
    organization_idstringrequired
    ID of the Elorus organization to act on, sent as the X-Elorus-Organization header. Find it in Elorus under Settings > Organization (the ID shown in the API section) or in the web app URL. Example: 1234567890123456.
  • elorus_cash_receipts_listList Elorus cash receipts with search, filters, ordering and paging.Read-only

    List Cash Receipts

    List Elorus cash receipts with search, filters, ordering and paging. Returns count, next, previous and results[] of cash receipts. Use elorus_cash_receipt_get for one cash receipt.

    Inputs

    organization_idstringrequired
    ID of the Elorus organization to act on, sent as the X-Elorus-Organization header. Find it in Elorus under Settings > Organization (the ID shown in the API section) or in the web app URL. Example: 1234567890123456.
    contactstring
    Optionally filter by contact ID. Example: 3300000040000100.
    created_afterstring
    Optionally filter results from a date onwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-01.
    created_beforestring
    Optionally filter results from a date backwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-30.
    currency_codestring
    Optionally filter by currency code. Example: EUR.
    custom_idstring
    Optionally filter by custom ID. Example: ABC-123-a1.
    invoicestring
    Optionally filter by invoice ID. Example: 8800000040088865.
    is_voidstring
    Optionally filter by void status. The available choices are: 1, 0.
    modified_afterstring
    Optionally filter results from a date onwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-01.
    modified_beforestring
    Optionally filter results from a date backwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-30.
    orderingstring
    Which field to use when ordering the results. A comma-separated list, if more than one is provided. The available fields are date, amount, branch__branch_name, contact__display_name, modified, created. Prepend a - to denote reverse ordering (e.g -date). Example: -created.
    pageinteger
    A page number within the paginated result set. Example: 1.
    page_sizeinteger
    Number of results to return per page. Default is 100. The maximum allowed value is 250.
    pending_approvalstring
    Optionally filter by pending status. The available choices are: 1, 0.
    periodstring
    Optionally filter results from a date period. Date period must be one of the following constants: today,current_week, current_month, current_year, last_week, last_month, last_year or in the form of this template last_ _
    period_fromstring
    Optionally filter results from a date onwards. Must be used with the period_to parameter, otherwise it won't have any effect. Date must be in the form of YYYY-mm-dd. Example: 2026-11-01.
    period_tostring
    Optionally filter results from a date backwards. Must be used with the period_from parameter, otherwise it won't have any effect. Date must be in the form of YYYY-mm-dd. Example: 2026-11-30.
    purchasecreditnotestring
    Optionally filter by supplier credit ID. Example: 1.
    searchstring
    A search term. Example: Acme.
    transaction_typestring
    Optionally filter by transaction type. Either dp, ip or cnp
  • elorus_contact_getGet one Elorus contact by ID.Read-only

    Get Contact

    Get one Elorus contact by ID. Returns all of the contact's fields. Use elorus_contacts_list to find the ID.

    Inputs

    idstringrequired
    ID of the contact (client or supplier). Example: 4400000040000123.
    organization_idstringrequired
    ID of the Elorus organization to act on, sent as the X-Elorus-Organization header. Find it in Elorus under Settings > Organization (the ID shown in the API section) or in the web app URL. Example: 1234567890123456.
  • elorus_contacts_listList Elorus contacts with search, filters, ordering and paging.Read-only

    List Contacts

    List Elorus contacts with search, filters, ordering and paging. Returns count, next, previous and results[] of contacts. Use elorus_contact_get for one contact.

    Inputs

    organization_idstringrequired
    ID of the Elorus organization to act on, sent as the X-Elorus-Organization header. Find it in Elorus under Settings > Organization (the ID shown in the API section) or in the web app URL. Example: 1234567890123456.
    activestring
    Whether to show only active or inactive (archived) records. The available choices are: 1, 0.
    companystring
    Optionally filter by company. Example: Acme Inc..
    created_afterstring
    Optionally filter results from a date onwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-01.
    created_beforestring
    Optionally filter results from a date backwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-30.
    ctypestring
    Optionally filter by contact type. The available choices are: client, supplier.
    custom_idstring
    Optionally filter by custom ID. Example: ABC-123-a1.
    letterstring
    Optionally filter by starting letter. Refers to the contact's "display_name." Example: A.
    modified_afterstring
    Optionally filter results from a date onwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-01.
    modified_beforestring
    Optionally filter results from a date backwards. Date must be in the form of YYYY-mm-dd or ISO-formatted. Example: 2026-11-30.
    orderingstring
    Which field to use when ordering the results. A comma-separated list, if more than one is provided. The available fields are display_name, profession, vat_number, modified, created. Prepend a - to denote reverse ordering (e.g -display_name). Example: -created.
    pageinteger
    A page number within the paginated result set. Example: 1.
    page_sizeinteger
    Number of results to return per page. Default is 100. The maximum allowed value is 250.
    professionstring
    Optionally filter by profession. Example: Consultant.
    searchstring
    A search term. Example: Acme.