{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}
At a glance
- Availability: Experimental (how to enable).
- Authentication: API key.
- Connection: The key from
SEVDESK_API_KEYis sent as theAuthorizationheader. - Provider documentation: Authentication reference.
Credentials
Set these per environment. See Connect an integration.
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>".
Provider notes
- 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
Verify the connection
Call a read tool such as sevdesk__list_contacts with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.