sevdesk

{/* 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_KEY is sent as the Authorization header.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
SEVDESK_API_KEYYessevdesk API token (32-character hexadecimal string), found in your sevdesk user settings. Sent raw in the Authorization header without a prefix. Docs.

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

ToolAccessDescription
List Contacts<br /><code className="reference-identifier">sevdesk__list_contacts</code>ReadList contacts
List Invoices<br /><code className="reference-identifier">sevdesk__list_invoices</code>ReadList invoices
Get Invoice<br /><code className="reference-identifier">sevdesk__get_invoice</code>ReadGet invoice
Create Invoice<br /><code className="reference-identifier">sevdesk__create_invoice</code>WriteCreate invoice
Upload Voucher File<br /><code className="reference-identifier">sevdesk__upload_voucher_file</code>WriteUpload voucher file
List Vouchers<br /><code className="reference-identifier">sevdesk__list_vouchers</code>ReadList vouchers
Create Voucher<br /><code className="reference-identifier">sevdesk__create_voucher</code>WriteCreate voucher
Get Invoice PDF<br /><code className="reference-identifier">sevdesk__get_invoice_pdf</code>ReadGet invoice PDF
Book Invoice Amount<br /><code className="reference-identifier">sevdesk__book_invoice_amount</code>WriteRecord invoice payment

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.