sevDesk icon

sevDesk

Consume the sevDesk API
Join our community

Actions41

Overview

This node integrates with the sevDesk API to send an invoice via email. It allows users to specify an existing invoice by its ID and send it directly to a recipient's email address with customizable subject and message content. This is particularly useful for automating invoicing workflows, such as sending invoices immediately after creation or on scheduled intervals without manual intervention.

Practical examples include:

  • Automatically emailing invoices to clients once they are generated.
  • Sending reminders or follow-ups with invoice attachments.
  • Including additional documents or CC/BCC recipients in the invoice email.

Properties

Name Meaning
Invoice ID The unique identifier of the invoice to be sent via email.
To Email The primary recipient's email address.
Subject The subject line of the email.
Text The body content of the email; supports plain text or HTML formatting.
Additional Fields A collection of optional fields:
- Copy Whether to send a copy of the email to yourself (boolean).
- Additional Attachments IDs of extra documents in the sevDesk account to attach, provided as a comma-separated string.
- CC Email Comma-separated list of email addresses to receive a carbon copy (CC).
- BCC Email Comma-separated list of email addresses to receive a blind carbon copy (BCC).

Output

The node outputs JSON data representing the response from the sevDesk API after attempting to send the invoice email. This typically includes status information about the email dispatch, such as success confirmation or error details.

If the node supports binary data output (not explicitly shown here), it would represent any files or attachments related to the invoice email.

Dependencies

  • Requires an active sevDesk API connection configured in n8n with appropriate authentication credentials (e.g., an API key).
  • Internet access to communicate with the sevDesk API endpoint at https://my.sevdesk.de/api/v1/.

Troubleshooting

  • Invalid Invoice ID: If the invoice ID does not exist or is incorrect, the API will likely return an error. Verify the invoice ID before sending.
  • Email Address Issues: Invalid or improperly formatted email addresses in "To Email", "CC Email", or "BCC Email" can cause failures.
  • Missing Required Fields: Ensure all required fields (Invoice ID, To Email, Subject, Text) are provided; otherwise, the request will fail.
  • API Authentication Errors: Incorrect or expired API credentials will prevent successful communication with sevDesk.
  • Attachment Errors: Providing invalid document IDs in additional attachments may cause the API to reject the request.

Resolving these issues generally involves verifying input values, checking API credentials, and ensuring network connectivity.

Links and References

Discussion