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 manage communication ways associated with contacts. Specifically, the "Update" operation for the "CommunicationWay" resource allows users to modify existing communication methods such as email addresses, phone numbers, websites, or mobile numbers linked to a contact.
Common scenarios include:
- Updating a contact's primary email address after it changes.
- Correcting or changing a phone number or website URL associated with a contact.
- Marking a different communication way as the main one for a contact.
Practical example:
- A user wants to update the phone number of a contact in their CRM system. They provide the unique ID of the communication way, specify the new phone number, and mark whether it is the main contact method.
Properties
| Name | Meaning |
|---|---|
| Communication Way ID | Unique identifier of the communication way to update. |
| Contact | Collection containing: • Contact ID: The contact to which this communication way belongs. • Object Name: Fixed as "Contact". |
| Key | Collection containing: • Key ID: The key of the communication way. • Object Name: Fixed as "CommunicationWayKey". |
| Communication Way Type | Type of the communication way. Options: Email, Phone, Web, Mobile. |
| Value | The actual value of the communication way, e.g., phone number, email address, or website URL. |
| Main | Boolean flag indicating if this is the main communication way for the contact. |
Output
The node outputs JSON data representing the updated communication way object returned by the sevDesk API. This typically includes all relevant fields of the communication way after the update, such as its ID, type, value, and main status.
No binary data output is involved.
Dependencies
- Requires an API key credential for authenticating with the sevDesk API.
- The base URL for API requests is
https://my.sevdesk.de/api/appended with the API version from credentials. - Environment configuration validation is performed before execution.
Troubleshooting
Common issues:
- Providing an invalid or non-existent Communication Way ID will result in errors from the API.
- Missing required fields like Contact or Key collections may cause request failures.
- Incorrect API credentials or expired tokens will lead to authentication errors.
Error messages:
- Errors returned from the API are captured and can be output as JSON error objects if "Continue On Fail" is enabled.
- Typical error messages include "Resource not found", "Invalid input data", or "Authentication failed".
Resolutions:
- Verify that the Communication Way ID exists and is correct.
- Ensure all required properties are provided and valid.
- Check API credentials and renew or reconfigure if necessary.