Actions41
- AccountingContact Actions
- Category Actions
- CheckAccount Actions
- CheckAccountTransaction Actions
- CommunicationWay Actions
- Contact Actions
- ContactAddress Actions
- Invoice Actions
- Part Actions
Overview
This node integrates with the sevDesk API to perform various operations related to sevDesk resources. Specifically, for the Contact resource and the Contact Customer Number Availability Check operation, it checks whether a given customer number is available or already in use within the sevDesk system. This is useful when you want to validate customer numbers before creating or updating contact records to avoid duplicates.
Practical examples include:
- Validating a customer number entered in a CRM form before saving.
- Automating data synchronization workflows where unique customer numbers are required.
- Preventing errors by pre-checking customer number availability during batch imports.
Properties
| Name | Meaning |
|---|---|
| Customer Number | The customer number string to be checked for availability in the sevDesk system. |
Output
The node outputs JSON data representing the response from the sevDesk API regarding the availability of the specified customer number. Typically, this will include fields indicating whether the customer number exists or is free to use.
If the node supports binary data output (not indicated here), it would represent any file or media content returned by the API, but for this operation, the output is purely JSON.
Dependencies
- Requires an active connection to the sevDesk API.
- Needs an API authentication token credential configured in n8n to authorize requests.
- The base URL used for API calls is
https://my.sevdesk.de/api/v1/.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Providing an empty or malformed customer number may result in API errors or unexpected responses.
- Network connectivity problems can prevent successful API calls.
Error messages:
- Authentication errors typically indicate invalid or expired API tokens; reconfigure the API credential.
- Validation errors from the API may indicate that the customer number format is incorrect.
- Timeout or network errors suggest checking internet connectivity or sevDesk service status.
Links and References
- sevDesk API Documentation (official API docs for detailed endpoint info)
- n8n documentation on creating custom nodes