sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API to manage various resources, including Contact Addresses. Specifically, the "Delete" operation for the Contact Address resource allows users to remove a contact address from their sevDesk account by specifying its unique ID. This is useful in scenarios where outdated or incorrect contact addresses need to be cleaned up or removed to maintain accurate records.

Practical examples include:

  • Automatically deleting a contact address when a customer record is deleted.
  • Cleaning up test or temporary contact addresses created during data imports or integrations.

Properties

Name Meaning
Contact Address ID The unique identifier of the contact address to delete. This is a required string value.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will include confirmation that the contact address was successfully deleted or an error message if the deletion failed.

If the operation fails and "Continue On Fail" is enabled, the output JSON will contain an error field with the error message related to the failure.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the sevDesk API.
  • The node uses the base URL https://my.sevdesk.de/api/ combined with the API version specified in credentials.
  • Environment configuration validation is performed before execution to ensure necessary environment variables or settings are correctly set.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Contact Address ID will cause the API to return an error.
    • Missing or incorrect API authentication credentials will prevent successful communication with the sevDesk API.
    • Network connectivity issues can cause request failures.
  • Error messages:

    • Errors returned from the API will be included in the output JSON under the error field if "Continue On Fail" is enabled.
    • Common errors include "Contact Address not found" or authentication errors.
  • Resolution tips:

    • Verify the Contact Address ID is correct and exists in sevDesk.
    • Ensure the API key credential is valid and has sufficient permissions.
    • Check network connectivity and API endpoint accessibility.
    • Enable "Continue On Fail" to handle errors gracefully within workflows.

Links and References

Discussion