Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to sevDesk

Scalekit connector
Open markdown

The sevDesk connector lets your AI agent act in each user's sevDesk account. Each user connects their own sevDesk 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
26 · 28 · 626 read28 write6 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 sevDesk connection

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

    Each user opens the link once and enters their sevDesk 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
  • sevdesk_check_account_balance_getGet a check account's balance at a date, summing all transactions up to the end of that day.Read-only

    Get Check Account Balance

    Get a check account's balance at a date, summing all transactions up to the end of that day. Returns objects with the balance. Use sevdesk_check_account_balance_get to reconcile an account.

    Inputs

    check_account_idintegerrequired
    ID of check account. Example: 5001.
    datestringrequired
    Date to compute the balance for, as YYYY-MM-DD; transactions up to 23:59:59 that day count. Example: 2026-12-31.
  • sevdesk_check_account_transactions_listList bank and cash transactions, filtered by check account, booking state, purpose, date range, payee or direction.Read-only

    List Check Account Transactions

    List bank and cash transactions, filtered by check account, booking state, purpose, date range, payee or direction. Returns objects[] of transactions with id, valueDate, amount, paymtPurpose, payeePayerName and status. Use sevdesk_check_account_transactions_list to find a transaction to link when booking an invoice or voucher.

    Inputs

    check_account_idinteger
    Only transactions on this check account ID. Example: 5001.
    count_allboolean
    Set to true to include the total number of matching records in the response. Example: true.
    embedstring
    Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
    end_datestring
    Only retrieve transactions up to this date. Example: 2026-12-31.
    is_bookedboolean
    Only retrieve booked transactions. Example: false.
    limitinteger
    Maximum number of entries to return, 1 to 1000. Example: 100.
    offsetinteger
    Number of entries to skip before returning results, for paging. Example: 0.
    only_creditboolean
    Only retrieve credit transactions. Example: true.
    only_debitboolean
    Only retrieve debit transactions. Example: false.
    payee_payer_namestring
    Only retrieve transactions with this payee / payer. Example: Acme GmbH.
    paymt_purposestring
    Only retrieve transactions with this payment purpose. Example: RE-1001.
    start_datestring
    Only retrieve transactions from this date on. Example: 2026-12-01.
  • sevdesk_check_accounts_listList check accounts (bank accounts, cash registers and clearing accounts).Read-only

    List Check Accounts

    List check accounts (bank accounts, cash registers and clearing accounts). Returns objects[] with id, name, type, iban, currency and status. Use sevdesk_check_accounts_list to find the check account ID needed for bookings and transactions.

    Inputs

    count_allboolean
    Set to true to include the total number of matching records in the response. Example: true.
    embedstring
    Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
    limitinteger
    Maximum number of entries to return, 1 to 1000. Example: 100.
    offsetinteger
    Number of entries to skip before returning results, for paging. Example: 0.
  • sevdesk_communication_way_keys_listList the labels a communication way can have, such as Private, Work, Fax, Mobile or Office.Read-only

    List Communication Way Keys

    List the labels a communication way can have, such as Private, Work, Fax, Mobile or Office. Returns objects[] with id and name. Use it to get the key ID for sevdesk_communication_way_create.

    Inputs

    This tool takes no inputs.

  • sevdesk_communication_ways_listList email addresses, phone numbers and websites of contacts, optionally for one contact or type.Read-only

    List Communication Ways

    List email addresses, phone numbers and websites of contacts, optionally for one contact or type. Returns objects[] with id, contact, type, value, key and main. Use sevdesk_communication_ways_list to read a contact's email or phone.

    Inputs

    contact_idinteger
    Only return records for this contact ID. Example: 12345.
    count_allboolean
    Set to true to include the total number of matching records in the response. Example: true.
    embedstring
    Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
    limitinteger
    Maximum number of entries to return, 1 to 1000. Example: 100.
    mainstring
    Define if you only want the main communication way. Example: 0.one of 01
    offsetinteger
    Number of entries to skip before returning results, for paging. Example: 0.
    typestring
    Type of the communication ways you want to get. Example: PHONE.one of PHONEEMAILWEBMOBILE
  • sevdesk_contact_addresses_listList all contact addresses.Read-only

    List Contact Addresses

    List all contact addresses. Returns objects[] of addresses with id, contact, street, zip, city, country and category. Use sevdesk_contact_addresses_list to find an address ID for sevdesk_contact_address_update or sevdesk_contact_address_delete.

    Inputs

    count_allboolean
    Set to true to include the total number of matching records in the response. Example: true.
    embedstring
    Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
    limitinteger
    Maximum number of entries to return, 1 to 1000. Example: 100.
    offsetinteger
    Number of entries to skip before returning results, for paging. Example: 0.
  • sevdesk_contact_getGet one contact by ID.Read-only

    Get Contact

    Get one contact by ID. Returns objects[] with the contact's name, customerNumber, category, status, tax and bank details. Use sevdesk_contact_get when you have the ID. Use sevdesk_contacts_list to find it.

    Inputs

    contact_idintegerrequired
    ID of contact to return. Example: 12345.
    embedstring
    Comma-separated nested resources to expand in full instead of id and objectName, for example contact or category. Example: contact.
  • sevdesk_contact_next_customer_number_getGet the next free customer number.Read-only

    Get Next Customer Number

    Get the next free customer number. Returns objects with the customer number string. Use before sevdesk_contact_create to give a new contact a unique customer number.

    Inputs

    This tool takes no inputs.