Sevdesk | Composio Docs

Overview

SLUG: SEVDESK

Description

sevDesk is an online accounting software designed for small businesses and freelancers, offering features like invoicing, expense management, and financial reporting.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Sevdesk

Create an auth config

Use the dashboard to create an auth config for the Sevdesk toolkit. This allows you to connect multiple Sevdesk accounts to Composio for agents to use.

Select App

Navigate to Sevdesk.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Sevdesk Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 sevdesk_auth_config_id = "ac_YOUR_SEVDESK_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Sevdesk for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, sevdesk_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Sevdesk toolkit’s playground

For code examples, see the Tool calling guide and Provider examples.

Tool List

SEVDESK_CREATE_CONTACT

Tool Name: Create Contact

Description

Tool to create a new contact in SevDesk. Use when you need to add a person or company record. Run after confirming all required details.

Action Parameters

academicTitle

address

bankDetails

birthday

SEVDESK_CREATE_PAYMENT_METHOD

Tool Name: Create Payment Method

Description

Tool to create a new payment method. Use when you need to add custom payment options in sevDesk.

Action Parameters

isActive

name

stringRequired

type

stringRequired

Action Response

data

error

objects

successful

booleanRequired

total

SEVDESK_DELETE_CONTACT

Tool Name: Delete Contact

Description

Tool to delete a specific contact by its ID. Use after confirming the contact exists. Example: "Delete contact with ID 12345".

Action Parameters

integerRequired

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_DELETE_PAYMENT_METHOD

Tool Name: Delete Payment Method

Description

Tool to delete a payment method. Use when you need to remove an existing payment method after confirming its ID.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_ACCOUNT_INVOICES

Tool Name: Get SevClient Account Invoices

Description

Tool to retrieve sevDesk account invoices. Use when you need to list all invoices for the authenticated client after confirming valid credentials.

Action Parameters

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_CHECK_ACCOUNTS

Tool Name: Get Check Accounts

Description

Tool to retrieve a list of all check accounts. Use when you need to view or select available bank accounts in sevDesk.

Action Parameters

embed

limit

offset

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_CHECK_ACCOUNT_TRANSACTIONS

Tool Name: Get Check Account Transactions

Description

Tool to retrieve list of check account transactions. Use when you need to fetch transactions with optional filters (e.g., account ID, date, status) after verifying the check account exists.

Action Parameters

amount

checkAccount

direction

embed

limit

offset

status

voucherDate

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_CONTACT_BY_ID

Tool Name: Get Contact By ID

Description

Tool to retrieve details of a specific contact by ID. Use when you have a contact's UUID and need its detailed information.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_CONTACTS

Tool Name: Get Contacts

Description

Tool to retrieve a list of contacts. Use when you need to fetch contacts from sevdesk with optional filters.

Action Parameters

SEVDESK_GET_CREDIT_NOTES

Tool Name: Get Credit Notes

Description

Tool to retrieve a list of credit notes. Use when you need to fetch multiple or filtered credit note records after confirming filters.

Action Parameters

contact[familyname]

contact[id]

contact[surname]

creditNoteNumber

customer[customerNumber]

customer[id]

customer[name]

embed

limit

offset

order

status

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_INVOICES

Tool Name: Get Invoices

Description

Tool to retrieve a list of invoices. Use when filtering or paginating invoice records. Run after confirming invoices exist.

Action Parameters

contact[id]

customerInternalNote

deliveryDate

dueDate

embed

invoiceDate

limit

number

offset

order

status

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_ORDERS

Tool Name: Get Orders

Description

Tool to retrieve a paginated list of orders. Use when you need to list orders with optional filters and pagination.

Action Parameters

embed

filter[customer]

filter[search]

filter[status]

limit

offset

order

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_PART_CONTACT_PRICES

Tool Name: Get Part Contact Prices

Description

Tool to retrieve a list of part contact prices. Use when you need to fetch pricing details for parts linked to contacts, with optional filters, pagination, and embedding of related objects.

Action Parameters

contact

embed

fields

includeDeleted

limit

offset

part

updatedAfter

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_PARTS

Tool Name: Get Parts

Description

Tool to retrieve a list of all parts. Use when you need to list available products or services for selection.

Action Parameters

archived

embed

limit

offset

properties

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_PART_UNITIES

Tool Name: Get Part Unities

Description

Tool to retrieve a list of all part unities. Use when you need to browse or filter units of measurement in SevDesk.

Action Parameters

embed

includeDeleted

limit

offset

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_PAYMENT_METHODS

Tool Name: Get Payment Methods

Description

Tool to retrieve a list of payment methods. Use when you need to browse available payment methods in Sevdesk with optional pagination.

Action Parameters

embed

limit

offset

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_PLACES

Tool Name: Get Places

Description

Tool to retrieve an overview of all places. Use when you need to list and paginate places in your sevDesk account.

Action Parameters

countAll

depth

embed

limit

offset

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_SEV_CLIENT_CONFIG

Tool Name: Get SevClient Config

Description

Tool to get sevClient configuration. Use when you need an overview of your sevClient settings after authenticating.

Action Parameters

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_GET_TAX_RULES

Tool Name: Get Tax Rules

Description

Tool to retrieve a list of tax rules. Use when you need to fetch tax configurations from SevDesk.

Action Parameters

embed

includeDeleted

limit

offset

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_UPDATE_CHECK_ACCOUNT

Tool Name: Update Check Account

Description

Tool to update an existing check account by ID. Use when you need to modify bank account details (e.g., IBAN, BIC) for a specific account ID.

Action Parameters

accountHolder

active

bankAccountNumber

bankCode

bankName

bic

customer

default

description

iban

integerRequired

Action Response

data

objectRequired

error

successful

booleanRequired

SEVDESK_UPDATE_CONTACT

Tool Name: Update Contact

Description

Tool to update an existing contact's details. Use after confirming the contact ID. Example: "Update contact with ID 123e4567-e89b-12d3-a456-426614174000".

Action Parameters

academicTitle

address

bankDetails