sevDesk icon

sevDesk

Consume the sevDesk API
Join our community

Actions98

Overview

The node integrates with the sevDesk API to update contact information within a sevDesk account. It allows users to modify various attributes of an existing contact, such as name, status, customer number, category, and other personal or organizational details.

This node is beneficial in scenarios where contact data needs to be kept up-to-date automatically, for example:

  • Synchronizing contact updates from a CRM system into sevDesk.
  • Automating batch updates of customer records based on external triggers.
  • Maintaining accurate billing or communication information for contacts in sevDesk.

Practical example: A business receives updated customer information from a web form and uses this node to update the corresponding contact record in sevDesk, ensuring all financial and communication processes use the latest data.

Properties

Name Meaning
Contact ID The unique identifier of the contact to update. This is required to specify which contact record will be modified.
Update Fields A collection of fields to update on the contact. These include:
- Name The organization name. If set, the contact is treated as an organization rather than an individual.
- Status Numeric status of the contact: 100 (Lead), 500 (Pending), 1000 (Active).
- Customer Number A unique customer number associated with the contact. Required field.
- Parent Information about the parent contact (must be an organization) to which this contact belongs. Includes ID and object name.
- Surename The first name of the contact (for individuals).
- Familyname The last name of the contact (for individuals).
- Title A non-academic title for the contact (not used for organizations).
- Category The category classification of the contact. Required field. Includes ID and object name.
- Description Additional descriptive text about the contact.
- Academic Title An academic title for the contact (not used for organizations).
- Gender Gender of the contact (not used for organizations).
- Name 2 Secondary name field.
- Birthday Birthday date of the contact.
- Vat Number VAT identification number.
- Bank Account Bank account number associated with the contact.
- Bank Number Bank routing number.
- Default Cashback Time Default time period for cashback calculations.
- Default Cashback Percent Default cashback percentage rate.
- Default Discount Amount Default discount amount applied to the contact.
- Default Discount Percentage Boolean indicating if default discount is a percentage.
- Default Time To Pay Default payment term duration.
- Tax Number Tax identification number.
- Exempt Vat Boolean flag indicating if the contact is exempt from VAT.
- Buyer Reference Reference string for buyer identification.
- Government Agency Boolean flag indicating if the contact is a government agency.

Output

The node outputs JSON data representing the response from the sevDesk API after attempting to update the contact. This typically includes the updated contact object with its current state as stored in sevDesk.

If an error occurs during the update operation and "Continue On Fail" is enabled, the output will contain an error message describing the failure for the specific item.

No binary data output is produced by this node.

Dependencies

  • Requires an active sevDesk API key credential configured in n8n to authenticate requests.
  • The node communicates with the sevDesk REST API endpoint at https://my.sevdesk.de/api/.
  • Environment configuration validation is performed before execution to ensure necessary environment variables or settings are present.

Troubleshooting

  • Common issues:

    • Invalid or missing Contact ID will cause the update to fail because the target contact cannot be identified.
    • Providing invalid field values (e.g., incorrect data types or missing required fields like Customer Number or Category) may result in API errors.
    • Network connectivity problems or incorrect API credentials will prevent successful communication with sevDesk.

  • Error messages:

    • Errors returned from the API are captured and can be output per item if "Continue On Fail" is enabled.
    • Typical error messages might indicate missing required fields, invalid IDs, or authentication failures.

  • Resolution tips:

    • Verify that the Contact ID corresponds to an existing contact in sevDesk.
    • Ensure all required fields in the update collection are provided and correctly formatted.
    • Confirm that the API key credential is valid and has sufficient permissions.
    • Check network connectivity and proxy settings if applicable.

Links and References

Discussion