sevDesk

Consume the sevDesk API

Actions98

Contact Actions
- Get Many
- Check Customer Number Availability
- Create
- Delete
- Find By Custom Field Value
- Get
- Get Number of Items
- Is Deletable
- Update
AccountingContact Actions
- Create
- Delete
- Get
- Get Many
- Update
Category Actions
- Get Many
CheckAccount Actions
- Create Clearing Account
- Create File Import Account
- Delete
- Get
- Get Balance at Date
- Update
CheckAccountTransaction Actions
- Create
- Delete
- Get Many
- Update
CommunicationWay Actions
- Create
- Delete
- Get
- Get Many
- Update
Contact Address Actions
- Create
- Delete
- Get
- Update
Contact Custom Field Actions
- Create
- Delete
- Get
- Update
Contact Custom Field Setting Actions
- Create
- Delete
- Get
- Update
Credit Note Actions
- Book
- Create
- Create From Invoice
- Delete
- Enshrine
- Get
- Get Many
- Get PDF
- Mark As Sent
- Reset Status To Draft
- Reset Status To Open
- Send By Email
- Send By Printing
- Update
Credit Note Po Actions
- Get Many
Export Actions
- Update Export Config
- Export DATEV (Deprecated)
- Start DATEV CSV Zip Export
- Start DATEV XML Zip Export
- Generate Download Hash
- Get Progress
- Get Job Download Info
- Export Invoice as CSV
- Export Invoice as Zip
- Export Credit Note as CSV
- Export Voucher as CSV
- Export Voucher as Zip
- Export Transaction as CSV
- Export Contact as CSV
Part Actions
- Get Many
- Create
- Get
- Get Stock
- Update
Invoice Actions
- Get Many
Invoice Position Actions
- Get Many
Order Actions
- Create
- Create Invoice
- Delete
- Download PDF
- Get
- Get Many
- Send By Email
- Update
Order Position Actions
- Get Many
- Get
- Update
- Delete
Report Actions
- Get Many
Tag Actions
- Create
- Delete
- Get
- Get Many
- Update
Voucher Actions
- Get Many
VoucherPo Actions
- Get Many

Overview

This node integrates with the sevDesk API to perform operations on various resources, including Contact Custom Fields. Specifically, the "Get" operation for the Contact Custom Field resource retrieves detailed information about a specific custom field associated with a contact in sevDesk.

Common scenarios where this node is beneficial include:

Fetching metadata or values of custom fields defined for contacts to use in workflows.
Synchronizing contact custom field data between sevDesk and other systems.
Automating reporting or data enrichment processes that require access to custom contact attributes.

For example, you might use this node to get the details of a particular custom field by its ID to display or process it further in your automation.

Properties

Name	Meaning
Contact Custom Field ID	The unique identifier (string) of the contact custom field to retrieve. This property is required for the Get operation on the Contact Custom Field resource.

Output

The node outputs an array of JSON objects representing the retrieved contact custom field(s). Each output item contains the full details of the requested contact custom field as returned by the sevDesk API.

If the node encounters an error during execution and "Continue On Fail" is enabled, the output will include an object with an error field describing the issue.

No binary data output is produced by this operation.

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/ combined with the API version specified in credentials.
Environment configuration validation is performed before execution to ensure proper setup.

Troubleshooting

Common issues:
- Invalid or missing Contact Custom Field ID will cause the API call to fail.
- Incorrect or expired API credentials will result in authentication errors.
- Network connectivity problems can prevent successful API requests.
Error messages:
- Errors from the API are caught and returned in the output if "Continue On Fail" is enabled.
- Typical error messages include "Not Found" if the custom field ID does not exist, or "Unauthorized" if credentials are invalid.
Resolution tips:
- Verify the Contact Custom Field ID is correct and exists in sevDesk.
- Ensure API credentials are valid and have sufficient permissions.
- Check network connectivity and proxy settings if applicable.

Links and References

sevDesk API Documentation (for detailed API endpoints and data structures)
n8n documentation on creating and using API credentials
n8n community forums for troubleshooting and examples

sevDeskInstall