sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API to manage contact addresses. Specifically, the "Delete" operation under the "ContactAddress" resource allows users to remove a contact address by its unique identifier. This is useful in scenarios where outdated or incorrect contact address information needs to be cleaned up from the system.

Practical examples include:

  • Automatically deleting obsolete contact addresses during data synchronization.
  • Removing contact addresses that are no longer valid or associated with contacts.

Properties

Name Meaning
Contact Address ID The unique numeric identifier of the contact address to delete. This property is required for the delete operation.

Output

The output JSON typically contains the response from the sevDesk API after attempting to delete the specified contact address. This usually includes confirmation of deletion or an error message if the deletion failed.

No binary data output is expected from this operation.

Dependencies

  • Requires an active connection to the sevDesk API.
  • An API authentication token (API key credential) must be configured in n8n to authorize requests.
  • The base URL used for API requests is https://my.sevdesk.de/api/v1/.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Contact Address ID will result in an error from the API.
    • Missing or incorrect API credentials will cause authentication failures.
    • Network connectivity problems can prevent successful API calls.
  • Error messages and resolutions:

    • "Unauthorized" or similar: Check that the API key credential is correctly set up and has sufficient permissions.
    • "Not Found" or "Contact Address does not exist": Verify that the Contact Address ID is correct and exists in sevDesk.
    • "Bad Request": Ensure the Contact Address ID is provided and is a valid number.

Links and References

Discussion