sevDeskInstall

Overview

This node integrates with the sevDesk API to manage various resources, including Contact Custom Field Settings. Specifically, the "Delete" operation for the Contact Custom Field Setting resource allows users to remove a custom field setting associated with a contact in sevDesk. This is useful when you want to clean up or remove obsolete custom data fields linked to contacts.

Practical examples:

• Automatically deleting a custom field setting when a related project or campaign ends.
• Removing incorrect or duplicate custom field settings from contacts during data maintenance workflows.

Properties

Output

The output is an array of JSON objects corresponding to each input item processed. For the Delete operation, the output typically contains confirmation of deletion or any error messages if the deletion failed.

Example output structure for a successful deletion might be:

{
  "json": {
    "id": "12345",
    "deleted": true
  }
}

If an error occurs and "Continue On Fail" is enabled, the output will include an error message like:

{
  "json": {
    "error": "Error message describing what went wrong"
  },
  "pairedItem": {
    "item": 0
  }
}

No binary data output is expected from 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.
• No additional external dependencies beyond the sevDesk API and its authentication are needed.

Troubleshooting

• Common issues:

  • Invalid or missing Contact Custom Field Setting ID will cause the deletion to fail.
  • Authentication errors if the API key credential is invalid or expired.
  • Network connectivity issues preventing access to the sevDesk API.

• Common error messages:

  • "error": "Not Found" — The specified Contact Custom Field Setting ID does not exist. Verify the ID is correct.
  • "error": "Unauthorized" — Authentication failed. Check that the API key credential is valid and has necessary permissions.
  • "error": "Bad Request" — The request parameters are invalid or incomplete. Ensure all required properties are set correctly.

• To resolve errors, verify input IDs, check API credentials, and ensure network connectivity.

Links and References

• sevDesk API Documentation (official API docs for reference)
• n8n documentation on creating custom nodes