sevDesk icon

sevDesk

Consume the sevDesk API
Join our community

Actions41

Overview

This node integrates with the sevDesk API to create a new check account. It is useful for automating financial workflows where you need to programmatically add bank or check accounts into your accounting system. Typical scenarios include setting up new accounts for bookkeeping, managing multiple currencies, or configuring import methods for transaction data.

For example, you might use this node to:

  • Automatically create a new online or offline check account when onboarding a new client.
  • Set up default accounts with specific currencies and statuses as part of a batch process.
  • Configure how transactions are imported and mapped to invoices or vouchers.

Properties

Name Meaning
Name The name of the check account to be created.
Type The type of the check account. Options: Online (accounts with CSV or MT940 import, or connected to bank applications) or Offline (accounts managed manually via API).
Currency The currency code of the check account, e.g., "EUR".
Status The status of the check account. Options: Archived (0) or Active (100).
Additional Fields A collection of optional fields:
- Import Type Method used to import transactions on this account. Options: CSV or MT940.
- Default Account Boolean indicating if this check account should be set as the default account.
- Auto Map Transactions Boolean indicating whether transactions imported on this account should automatically be mapped to invoices and vouchers if possible.

Output

The node outputs JSON data representing the newly created check account as returned by the sevDesk API. This typically includes details such as the account ID, name, type, currency, status, and any other metadata provided by the API response.

No binary data output is involved.

Dependencies

  • Requires an active sevDesk API key credential configured in n8n to authenticate requests.
  • Depends on the sevDesk REST API endpoint at https://my.sevdesk.de/api/v1/.

Troubleshooting

  • Authentication errors: Ensure that the API key credential is correctly set up and has sufficient permissions.
  • Validation errors: Missing required fields like Name, Type, Currency, or Status will cause the API to reject the request. Double-check all mandatory inputs.
  • Invalid import type: Only "CSV" or "MT940" are accepted for the import type; using other values will result in errors.
  • Status value issues: Use only the defined status options (0 for Archived, 100 for Active).
  • API connectivity problems: Verify network access to the sevDesk API URL and that no firewall or proxy blocks the connection.

Links and References

Discussion