---
title: "Email billing documents generated from a bill run"
method: POST
path: "/v1/bill-runs/{billRunKey}/emails"
tags: ["Bill Run"]
---

# Email billing documents generated from a bill run

`POST /v1/bill-runs/{billRunKey}/emails`

Manually emails all the billing documents that are generated from a specified bill run to your customers. 


Bill runs can generate invoices and credit memos based on your [invoice and credit memo generation rule](https://docs.zuora.com?resourceId=billing-invoice-and-credit-memo-generation-rule). Credit memos are only available if you have the Invoice Settlement feature enabled.


Using this API operation, the billing documents are sent to the email addresses specified in the **To Email** field of the email templates. The email template used for each billing document is set in the **Delivery Options** panel of the **Edit notification** dialog from the Zuora UI. See [Edit Email Templates](https://docs.zuora.com?resourceId=platform-create-email-template) for more information about how to edit the **To Email** field in the email template.





### Notes
  - Even though no field is required in the Request body, you still need to specify `{}` in the request. Otherwise, an error will be returned.


  - You can only email posted billing documents.


  - You must activate the following notifications before emailing invoices and credit memos:
    - **Manual Email For Invoice | Manual Email For Invoice** 
    - **Email Credit Memo | Manually email Credit Memo**


  - To include the invoice PDF in the email, select the **Include Invoice PDF** check box in the **Edit notification** dialog from the Zuora UI. To include the credit memo PDF in the email, select the **Include Credit Memo PDF** check box in the **Edit notification** dialog from the Zuora UI. See [Create and Edit Notifications](https://docs.zuora.com?resourceId=platform-create-notification) for more information.



  - Zuora sends the email messages based on the email template you set. You can set the email template to use in the **Delivery Options** panel of the **Edit notification** dialog from the Zuora UI. By default, the following templates are used for billing documents:
    - Invoices: **Invoice Posted Default Email Template**
    - Credit memos: **Manual Email for Credit Memo Default Template**  

    See [Create and Edit Email Templates](https://docs.zuora.com?resourceId=platform-create-email-template) for more information.

## Path parameters

- `billRunKey` string, required

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Request body

- POSTEmailBillingDocfromBillRunType
  - `resend` boolean — Whether to send out emails for all the billing documents that are associated with the bill run. - If the value is `false`, emails are sent out only for the billing documents that never have emails sent out. **Note**: Do not perform this API operation with the `resend` field set to `false` multiple times in a short period. Otherwise, you may receive the same email multiple times, which contradicts the purpose of this setting. - If the value is `true`, emails are sent out for all the billing documents.

## Response `200`

OK

- CommonResponse
  - `processId` string — The ID of the process that handles the operation.
  - `reasons` object[] — The container of the error code and message. This field is available only if the `success` field is `false`.
    - `code` string — The error code of response.
    - `message` string — The detail information of the error response
  - `requestId` string, uuid — Unique identifier of the request.
  - `success` boolean — Indicates whether the call succeeded.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)