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

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["SEVDESK"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

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

string

address

object

bankDetails

object

birthday

string

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

boolean

name

stringRequired

type

stringRequired

Action Response

data

object

error

string

objects

array

successful

booleanRequired

total

integer

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

string

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

string

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

string

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

string

limit

integer

offset

integer

Action Response

data

objectRequired

error

string

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

string

checkAccount

string

direction

string

embed

string

limit

integer

offset

integer

status

string

voucherDate

string

Action Response

data

objectRequired

error

string

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

string

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]

string

contact[id]

string

contact[surname]

string

creditNoteNumber

string

customer[customerNumber]

string

customer[id]

string

customer[name]

string

embed

string

limit

integer

offset

integer

order

string

status

string

Action Response

data

objectRequired

error

string

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]

string

customerInternalNote

string

deliveryDate

string

dueDate

string

embed

string

invoiceDate

string

limit

integer

number

string

offset

integer

order

string

status

string

Action Response

data

objectRequired

error

string

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

string

filter[customer]

string

filter[search]

string

filter[status]

string

limit

integer

offset

integer

order

string

Action Response

data

objectRequired

error

string

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

string

embed

string

fields

string

includeDeleted

boolean

limit

integer

offset

integer

part

string

updatedAfter

string

Action Response

data

objectRequired

error

string

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

boolean

embed

string

limit

integer

offset

integer

properties

string

Action Response

data

objectRequired

error

string

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

string

includeDeleted

boolean

limit

integer

offset

integer

Action Response

data

objectRequired

error

string

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

string

limit

integer

offset

integer

Action Response

data

objectRequired

error

string

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

boolean

depth

integer

embed

string

limit

integer

offset

integer

Action Response

data

objectRequired

error

string

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

string

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

string

includeDeleted

boolean

limit

integer

offset

integer

Action Response

data

objectRequired

error

string

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

string

active

boolean

bankAccountNumber

string

bankCode

string

bankName

string

bic

string

customer

object

default

boolean

description

string

iban

string

integerRequired

Action Response

data

objectRequired

error

string

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

string

address

object

bankDetails

object