sevdesk

At a glance

Availability: Experimental (how to enable).
Auth: API key.
Connection: The key from SEVDESK_API_KEY is sent as the Authorization header.
Docs: https://api.sevdesk.de/

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.

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.

Provider API reference: https://api.sevdesk.de/

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

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.