---
title: "Send invoice, quote, or reminder by email"
method: POST
path: "/invoices/{id}/send"
tags: ["Invoices"]
---

# Send invoice, quote, or reminder by email

`POST /invoices/{id}/send`

Sends an invoice/quote/reminder email and records a send log in `sentEmailHistory`.

Use `invoiceStatus` to control how the email is sent and logged:
- `invoice` (default) — standard invoice email
- `quote` or `offer` — quote/offer email
- `reminder` — payment reminder email
- `confirmation` — payment confirmation email

Alternatively, use `overrides` to set the invoice type or payment status for the email template.

## Request body

- object
  - `ccEmails` string[]
  - `invoiceStatus` 'invoice' | 'quote' | 'offer' | 'reminder' | 'confirmation' — Type of email to send. Controls the email template and is recorded in sentEmailHistory.
  - `locale` string
  - `overrides` object
  - `testMode` boolean
  - `toEmail` string, required
  - `userEmail` string

## Response `200`

Sent (or send attempted)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.dev/vocal/apis/magic-heidi-invoicing-software-api.md) · [All operations](https://skmtc.dev/vocal/apis/magic-heidi-invoicing-software-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vocal/magic-heidi-invoicing-software-api/revisions/591ae048f0a0/schema)