Actions98
- Contact Actions
- AccountingContact Actions
- Category Actions
- CheckAccount Actions
- CheckAccountTransaction Actions
- CommunicationWay Actions
- Contact Address Actions
- Contact Custom Field Actions
- Contact Custom Field Setting Actions
- Credit Note Actions
- Credit Note Po Actions
- 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
- Invoice Actions
- Invoice Position Actions
- Order Actions
- Order Position Actions
- Report Actions
- Tag Actions
- Voucher Actions
- VoucherPo Actions
Overview
This node integrates with the sevDesk API, allowing users to perform various operations on sevDesk resources. Specifically, for the "Contact Address" resource with the "Get" operation, it retrieves details of a specific contact address by its ID. This is useful when you need to fetch detailed information about a contact's address stored in sevDesk, such as for syncing contact data, verifying addresses, or using address details in other workflows.
Practical examples:
- Fetching a contact address to display or update customer records in another system.
- Retrieving address details before sending invoices or shipping notifications.
- Using the contact address data to validate or enrich CRM entries.
Properties
| Name | Meaning |
|---|---|
| Contact Address ID | The unique identifier of the contact address to retrieve. This is required to specify which contact address to get. |
Output
The node outputs JSON data representing the retrieved contact address object from sevDesk. The structure typically includes all fields related to the contact address, such as street, city, postal code, country, and any other metadata provided by the sevDesk API.
If the node encounters an error (e.g., invalid ID), it outputs a JSON object containing an error field with the error message.
No binary data output is involved in 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 at runtime to ensure necessary environment variables or settings are correct.
Troubleshooting
Common issues:
- Providing an invalid or non-existent Contact Address ID will result in an error response.
- Missing or incorrect API authentication credentials will cause authorization failures.
- Network connectivity problems can prevent successful API calls.
Error messages:
"error": "Contact Address not found"— Verify that the Contact Address ID is correct.- Authentication errors — Check that the API key credential is properly set up and has sufficient permissions.
- Validation warnings/errors from environment config — Ensure all required environment variables or configurations are correctly defined.
To resolve errors, confirm input parameters, verify API credentials, and check network access.
Links and References
- sevDesk API Documentation (official API docs for reference)
- n8n documentation on creating custom nodes