At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key from
SEVDESK_API_KEYis sent as theAuthorizationheader. - Docs: https://api.sevdesk.de/
Credentials
Set these per environment. See Connect an integration.| Variable | Required | Description |
|---|---|---|
SEVDESK_API_KEY | Yes | sevdesk API token (32-character hexadecimal string), found in your sevdesk user settings. Sent raw in the Authorization header without a prefix. Docs. |
Setup
- Create a sevdesk account: Sign up at https://sevdesk.de - a free trial account works for testing the API; there is no separate sandbox environment.
- Find your API token: Log in to https://my.sevdesk.de and open Settings > Users. Every administrator has one API token, a 32-character hexadecimal string. Copy it and set it as SEVDESK_API_KEY.
- Verify access: The token is sent as the raw value of the Authorization header on every request (no ‘Bearer’ prefix). Test with: curl https://my.sevdesk.de/api/v1/Contact -H “Authorization: <token>”.
- sevdesk API tokens have an infinite lifetime and grant the full permissions of the user they belong to; rotate them from the user settings if leaked.
- The REST base URL is https://my.sevdesk.de/api/v1 (the docs are hosted at api.sevdesk.de).
- List responses wrap results in an ‘objects’ array; pagination uses limit and offset query parameters.
- The saveInvoice and saveVoucher factory endpoints require fully specified models: every embedded object needs objectName and mapAll fields, and references use { id, objectName } pairs.
- Voucher/Factory/uploadTempFile is a multipart/form-data upload; the returned internal filename is referenced in the ‘filename’ field when saving an invoice or voucher.
Tools
| Tool | Access | Description |
|---|---|---|
| List Contacts | Read | List sevdesk contacts (organizations and persons), e.g. to find a contact id before creating an invoice |
| List Invoices | Read | List sevdesk invoices with optional status, number, date, and contact filters |
| Get Invoice | Read | Retrieve a single sevdesk invoice by its id |
| Create Invoice | Write | Create a sevdesk invoice with positions via the saveInvoice factory endpoint; create with status 100 for an editable draft |
| Upload Voucher File | Write | Upload a receipt or invoice file to sevdesk; returns an internal filename that can be attached when creating a voucher |
| List Vouchers | Read | List sevdesk accounting vouchers (receipts) with optional status, type, date, and description filters |
| Create Voucher | Write | Create a bookable voucher (receipt) with positions via the saveVoucher factory endpoint - the step that turns a file staged with Upload Voucher File into an actual accounting record |
| Get Invoice PDF | Read | Retrieve the rendered PDF document of an invoice for sending or archiving |
| Book Invoice Amount | Write | Register a (partial) payment on an invoice and mark it paid when settled - closes the reconciliation loop after money arrives |
Example prompts
- List my open sevdesk invoices and summarize who owes what.
- Upload this receipt to sevdesk so it can be booked as a voucher.
- Create a draft invoice in sevdesk for a customer; ask me for the positions first.