---
title: "Send a receivable via email"
method: POST
path: "/receivables/{receivable_id}/send"
tags: ["Receivables"]
---

# Send a receivable via email

`POST /receivables/{receivable_id}/send`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/receivables/{receivable_id}/send`
- Auth: HTTP bearer

Sends an email containing the specified invoice, quote, or credit note and its [attachments](https://docs.monite.com/accounts-receivable/customization/attachments) to the specified receipients. For more information, see [Send an invoice via email](https://docs.monite.com/accounts-receivable/invoices/create#send-via-email).

You can only send receivables that have the following statuses:

 * Invoices: `draft`, `issued`, `partially_paid`, `paid`, `overdue`.
   In the [non-compliant mode](https://docs.monite.com/accounts-receivable/regulatory-compliance/invoice-compliance):
   also `canceled`.
 * Quotes: `draft`, `issued`.
 * Credit notes: `draft`, `issued`.

Draft receivables are automatically moved to the `issued` status before being emailed. That is, you can use `/receivables/{receivable_id}/send` as a shortcut for `/receivables/{receivable_id}/issue` + `/send`, if needed. If issuing fails, the receivables remains in the `draft` status and no email is sent.

The counterpart's default email address, which is stored in the `counterpart_contact.email` field of the receivable, is automatically added to the `recipients.to` list.

The response contains the `mail_id` which you can pass to [`GET /receivables/{receivable_id}/mails/{mail_id}`](https://docs.monite.com/api/receivables/get-receivables-id-mails-id) to check the email sending status.

If you use [custom email templates](https://docs.monite.com/advanced/email-templates/index), note that Monite has separate template types for unpaid invoices, fully paid invoices, quotes, and credit notes.

## Path parameters

- `receivable_id` string, required

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Request body

- object
  - `body_text` string, required: A plain-text string to be inserted into the email body. Use new line characters `\n` to split the text into paragraphs. This text substitutes the `{{body_template}}` variable in the [email template](https://docs.monite.com/advanced/email-templates/index) used, whereas the template itself defines the HTML layout, styles, and formatting of the email body. In the default email templates, this text goes after the logo and heading but before the receivable's details. This text can include [variables](https://docs.monite.com/advanced/variables) as placeholders for document-specific and counterpart-specific data.
  - `recipients` Recipients
    - `bcc` string[]: A list of "Bcc" recipients.
    - `cc` string[]: A list of "Cc" recipients.
    - `to` string[]: A list of "To" recipients. The receivable's `counterpart_contact.email` address is automatically included in this list.
  - `subject_text` string, required: Email subject text. Can include [variables](https://docs.monite.com/advanced/variables).

## Response `200`

Successful Response

- ReceivableSendResponse: A schema for returning a response an email with a link to receivable document has been sent
  - `mail_id` string, uuid, required: A unique ID of the email sending operation triggered by this API call. You can pass this value to [`GET /receivables/{receivable_id}/mails/{mail_id}`](https://docs.monite.com/api/receivables/get-receivables-id-mails-id) to check the email sending status.

## Other responses

- `400`: Bad Request
- `401`: The `Authorization` header is missing or contains an invalid or expired access token. See [Authentication](https://docs.monite.com/api/concepts/authentication) to learn how to authenticate API calls.
- `403`: The specified access token does not have permissions to perform this operation.
- `404`: A receivable with the specified ID was not found.
- `409`: Unsupported receivable status for emails. Must be one of: `draft`, `issued`, `partially_paid`, `paid`, `overdue`, `canceled`.
- `422`: Validation Error
- `429`: API rate limit has been exceeded. Check the response headers for the rate limit information.

---

[API](https://skmtc.dev/monite/apis/monite-2.md) - [All operations](https://skmtc.dev/monite/apis/monite-2/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-2/revisions/4299ccf95edb?raw)