Send invoice
Finish a draft invoice and email it to the customer, as a PDF or an e-invoice.
POST https://cotlet.dev/api/v1/sevdesk/invoices/{invoice_id}
write Confirm
Finishes the invoice and sends it by email, like Als E-Mail versenden. The invoice number is fixed from this moment and the status changes to open. Format zugferd_pdf sends the PDF with the XML inside (ZUGFeRD); xrechnung_xml sends only the XML (X-Rechnung). Sending is final: if sevdesk is set to enshrine on finishing, the invoice cannot be edited afterwards. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| invoice_id string required | string | Invoice ID from list_invoices. |
| to_email string | string | Recipient. Default: the email address of the invoice contact. |
| subject string | string | Email subject. |
| message string | string | Email text. |
| format enum | enum | zugferd_pdf or xrechnung_xml. Default: zugferd_pdf. |
| copy_to_me boolean | boolean | Send a copy to your login email (Kopie an mich selbst). Default: false. |
Request
curl -X POST https://cotlet.dev/api/v1/sevdesk/invoices/41873190 \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"to_email":"accounts@nordlicht-studio.example","subject":"Invoice RE-1043","message":"Hello, please find our invoice RE-1043 attached. Payment is due within 14 days.","format":"zugferd_pdf"}'result = client.call("sevdesk", "send_invoice", {"invoice_id":"41873190","to_email":"accounts@nordlicht-studio.example","subject":"Invoice RE-1043","message":"Hello, please find our invoice RE-1043 attached. Payment is due within 14 days.","format":"zugferd_pdf"})const result = await cotlet.call('sevdesk', 'send_invoice', {"invoice_id":"41873190","to_email":"accounts@nordlicht-studio.example","subject":"Invoice RE-1043","message":"Hello, please find our invoice RE-1043 attached. Payment is due within 14 days.","format":"zugferd_pdf"});cotlet call sevdesk send_invoice --data '{"invoice_id":"41873190","to_email":"accounts@nordlicht-studio.example","subject":"Invoice RE-1043","message":"Hello, please find our invoice RE-1043 attached. Payment is due within 14 days.","format":"zugferd_pdf"}'Example response
{
"invoice_id": "41873190",
"invoice_number": "RE-1043",
"status": "open",
"sent_to": "accounts@nordlicht-studio.example",
"format": "zugferd_pdf",
"sent_at": "2026-10-14T10:42:00+02:00"
}