Skip to main content

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from SEVDESK_API_KEY is sent as the Authorization header.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

Setup

  1. 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.
  2. 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.
  3. 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.
Provider API reference.

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.