sevDesk icon

sevDesk

Consume the sevDesk API
Join our community

Actions41

Overview

This node integrates with the sevDesk API to create a new Contact resource. It allows users to add detailed contact information such as category, personal details, tax information, payment terms, and other optional fields. This is useful in scenarios where you want to automate the creation of contacts in sevDesk from external data sources or workflows, for example, adding new customers, suppliers, or partners automatically when they are registered in another system.

Practical examples:

  • Automatically creating a new customer contact in sevDesk when a user signs up on your website.
  • Adding supplier contacts from an inventory management system into sevDesk for accounting purposes.
  • Creating partner contacts with specific tax and payment terms for invoicing automation.

Properties

Name Meaning
Category Unique identifier of the contact category. Options include Supplier=2, Customer=3, Partner=4, Prospect Customer=28. Default is Customer (3).
Additional Fields A collection of optional fields to provide more detailed contact information:
- Academic Title An academic title for the contact (not for organizations).
- Bank Account Bank account number (IBAN) of the contact.
- Bank Number Bank number of the contact.
- Birthday Birthday of the contact (not for organizations).
- Customer Number Customer number assigned to the contact.
- Default Cashback Percent Percentage of invoice sum returned if invoices are paid on time.
- Default Cashback Time Time in days within which invoices must be paid to get cashback.
- Default Discount Amount Default discount amount applied to every invoice (absolute or percentage depending on flag).
- Default Discount Percentage Boolean indicating if discount is percentage (true) or absolute value (false).
- Default Time To Pay Payment goal in days set for every invoice of the contact.
- Description A description for the contact.
- Exempt Vat Boolean indicating if the contact is exempt from paying VAT.
- Last Name Last name of the contact (not for organizations).
- Gender Gender of the contact (not for organizations).
- Name Organization name. If set, the contact is treated as an organization.
- Second Name Second name of the contact (not for organizations).
- Parent ID Unique identifier of the parent contact.
- First Name First name of the contact (not for organizations).
- Tax Number Tax number of the contact.
- Tax Office Tax office responsible for the contact.
- Tax Set ID Tax set used in every invoice of the contact.
- Tax Type Tax regulation type used by the contact. One of "default", "eu", "noteu", "custom".
- Title Non-academic title for the contact (not for organizations).
- Vat Number VAT number of the contact.

Output

The node outputs JSON data representing the created contact object as returned by the sevDesk API. This typically includes all the contact details that were sent, along with any additional metadata or identifiers assigned by sevDesk upon creation.

If binary data output is supported by the node (not indicated here), it would represent associated files or attachments related to the contact, but this node primarily deals with JSON contact data.

Dependencies

  • Requires an active sevDesk API key credential configured in n8n to authenticate requests.
  • The node sends HTTP requests to the sevDesk API endpoint at https://my.sevdesk.de/api/v1/.
  • Proper permissions on the API key to create contacts are necessary.

Troubleshooting

  • Common issues:

    • Missing or invalid API credentials will cause authentication errors.
    • Providing invalid field values (e.g., wrong data types or invalid category IDs) may result in API validation errors.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • Authentication errors: Check that the API key credential is correctly set up and has required permissions.
    • Validation errors: Review the input properties for correctness, especially required fields like category ID.
    • Rate limiting or server errors: Retry after some time or check sevDesk service status.

Links and References

Discussion