Send invoice
Email an invoice to a recipient from Holded, with a link to the customer portal.
POST https://cotlet.dev/api/v1/holded/invoices/{invoice_id}
write Confirm
Sends one invoice from Holded by email or by post. The message includes a link to the invoice on the customer portal, and the email uses the mailing template linked to the document unless you pass a message. The recipient defaults to the email on the contact. 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 string | string | Recipient email address. Default: the email on the contact. |
| method enum | enum | email or post. Default: email. |
| message string | string | Message text. Default: the mailing template of the document. |
Request
curl -X POST https://cotlet.dev/api/v1/holded/invoices/inv_7d31 \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"to":"accounts@northwind.example","method":"email","message":"Hello, invoice INV-0045 for 968.00 was due on 2026-10-14. You can open it in the customer portal using the link below. Please let us know when it is paid."}'result = client.call("holded", "send_invoice", {"invoice_id":"inv_7d31","to":"accounts@northwind.example","method":"email","message":"Hello, invoice INV-0045 for 968.00 was due on 2026-10-14. You can open it in the customer portal using the link below. Please let us know when it is paid."})const result = await cotlet.call('holded', 'send_invoice', {"invoice_id":"inv_7d31","to":"accounts@northwind.example","method":"email","message":"Hello, invoice INV-0045 for 968.00 was due on 2026-10-14. You can open it in the customer portal using the link below. Please let us know when it is paid."});cotlet call holded send_invoice --data '{"invoice_id":"inv_7d31","to":"accounts@northwind.example","method":"email","message":"Hello, invoice INV-0045 for 968.00 was due on 2026-10-14. You can open it in the customer portal using the link below. Please let us know when it is paid."}'Example response
{
"invoice_id": "inv_7d31",
"number": "INV-0045",
"status": "sent",
"method": "email",
"to": "accounts@northwind.example",
"sent_at": "2026-10-14T09:15:00+02:00"
}