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 to update a contact address record. It allows users to modify details of an existing contact address such as street, city, zip code, country, category, and multiple name fields. This operation is useful in scenarios where contact address information needs to be kept current, for example, updating a customer's shipping or billing address after they move or change their contact details.
Practical examples include:
- Automatically updating customer addresses from form submissions.
- Synchronizing address changes from another CRM system.
- Correcting or enriching address data in bulk workflows.
Properties
| Name | Meaning |
|---|---|
| Contact Address ID | The unique identifier of the contact address to update (required). |
| Contact | Collection containing: • Contact ID: Identifier of the contact this address belongs to. • Object Name: Fixed string "Contact". (required) |
| Street | Street name of the contact address. |
| Zip Code | Postal or zip code of the contact address. |
| City | City of the contact address. |
| Country | Collection containing: • Country ID: Identifier of the country. • Object Name: Fixed string "StaticCountry". (required) |
| Category | Collection containing: • Category ID: Identifier of the category for the contact address. • Object Name: Fixed string "Category". (required) |
| Name | First name or primary name field in the address. |
| Name 2 | Second name field in the address. |
| Name 3 | Third name field in the address. |
| Name 4 | Fourth name field in the address. |
Output
The node outputs JSON data representing the updated contact address object returned by the sevDesk API. This typically includes all the updated fields along with metadata such as IDs and timestamps confirming the successful update.
No binary data output is produced by 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. - Proper environment configuration validation is performed before execution.
Troubleshooting
- Common issues:
- Missing or invalid Contact Address ID will cause the update to fail.
- Providing incomplete required collections (Contact, Country, Category) may result in errors.
- Network or authentication failures if the API key is incorrect or expired.
- Error messages:
- Errors from the API are caught and can be output as error JSON if "Continue On Fail" is enabled.
- Typical errors include "Not Found" if the Contact Address ID does not exist, or "Unauthorized" if credentials are invalid.
- Resolution tips:
- Verify that the Contact Address ID exists in sevDesk.
- Ensure all required fields and nested collections are correctly filled.
- Check API key validity and permissions.
- Enable "Continue On Fail" to handle errors gracefully in workflows.