sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API to retrieve multiple accounting contact records based on specified filters. It is useful for scenarios where you need to fetch a list of accounting contacts, such as syncing contact data from sevDesk into another system, generating reports, or automating workflows that depend on contact information.

For example, you might use this node to:

  • Retrieve all accounting contacts linked to specific contact IDs.
  • Filter accounting contacts by associated object names.
  • Bulk process or analyze accounting contact data within an n8n workflow.

Properties

Name Meaning
Contact Filter A collection of filters to narrow down which accounting contacts to retrieve. Options:
- Contact ID The unique identifier of the contact whose accounting contact information you want to get.
- Object Name The name of the object related to the contact (default is "Contact"). Required if Contact ID is provided.

Output

The node outputs an array of JSON objects representing the retrieved accounting contacts. Each item in the output corresponds to one accounting contact record fetched from the sevDesk API.

The json field contains the detailed data of each accounting contact, including fields as defined by the sevDesk API response for accounting contacts.

No binary data output is produced by this operation.

Dependencies

  • Requires an active sevDesk API key credential configured in n8n.
  • The node uses the sevDesk API endpoint at https://my.sevdesk.de/api/.
  • Environment configuration validation is performed before execution to ensure proper setup.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Providing incorrect or non-existent Contact IDs may result in empty results or errors.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • Errors returned from the API are captured and included in the output if "Continue On Fail" is enabled.
    • Typical error messages include authentication errors, invalid parameters, or rate limiting notices.
  • Resolutions:

    • Verify that the API key credential is correctly set up and has sufficient permissions.
    • Double-check filter values like Contact ID and Object Name for correctness.
    • Ensure stable internet connection and that the sevDesk API service is operational.

Links and References

Discussion