sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API to manage various resources, including Contact Custom Fields. Specifically, the "Delete" operation for the Contact Custom Field resource allows users to remove a custom field associated with a contact in sevDesk. This is useful when cleaning up unused or obsolete custom fields to keep contact data organized.

Practical examples:

  • Automatically deleting a custom field after it is no longer needed in your CRM workflow.
  • Removing test or temporary custom fields created during data import or migration processes.

Properties

Name Meaning
Contact Custom Field ID The unique identifier of the Contact Custom Field to delete. This is required to specify which custom field should be removed.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will include confirmation of deletion or any error messages if the operation failed. The output structure contains a json field with the response from the API.

No binary data output is expected from this operation.

Example output JSON might look like:

{
  "success": true,
  "id": "12345"
}

or, in case of failure:

{
  "error": "Custom field not found"
}

Dependencies

  • Requires an active connection to the sevDesk API via an API key credential configured in n8n.
  • The node uses the base URL https://my.sevdesk.de/api/ with the API version specified in credentials.
  • No additional external dependencies are required beyond the sevDesk API access.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Contact Custom Field ID will cause the delete operation to fail.
    • Network connectivity problems or incorrect API credentials will prevent successful communication with sevDesk.
  • Error messages and resolutions:

    • "Custom field not found": Verify that the Contact Custom Field ID is correct and exists in sevDesk.
    • "Unauthorized" or authentication errors: Check that the API key credential is valid and has sufficient permissions.
    • "Request failed" or timeout errors: Ensure network connectivity and that the sevDesk API service is operational.

Links and References

Discussion