---
title: "Changes to Sends an email for an entity"
method: POST
path: "/api/v1/emails"
---

# Changes to Sends an email for an entity

`POST /api/v1/emails`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 12 of 110 revisions.

- **2024-12-16** `d5c45b441b72`: 14 breaking, 14 info
- **2024-11-23** `a80e474b5da3`: 1 breaking, 15 info
- **2024-06-06** `8e82a2bd77e0`: 1 breaking, 2 info
- **2024-06-05** `e61df65649e2`: 1 breaking, 2 warning
- **2024-03-07** `71171a40d629`: 5 breaking, 8 info
- **2024-02-18** `88bbc1f38ff7`: 5 breaking, 8 warning
- **2024-02-10** `4ad0fff44c6c`: 4 info
- **2024-01-24** `9dab078a46b5`: 1 info
- **2024-01-20** `70cd94370516`: 1 breaking
- **2023-10-01** `464a36941b64`: 3 breaking, 1 info
- **2023-07-08** `627936439128`: 4 breaking
- **2023-02-18** `ab767c581aef`: 2 info

## Changes

- **2024-12-16** `d5c45b441b72`: 14 breaking, 14 info
  - removed the enum value `credit` of the request property `template`
  - removed the enum value `custom1` of the request property `template`
  - removed the enum value `custom2` of the request property `template`
  - removed the enum value `custom3` of the request property `template`
  - removed the enum value `invoice` of the request property `template`
  - removed the enum value `payment` of the request property `template`
  - removed the enum value `payment_partial` of the request property `template`
  - removed the enum value `purchase_order` of the request property `template`
  - removed the enum value `quote` of the request property `template`
  - removed the enum value `reminder1` of the request property `template`
  - removed the enum value `reminder2` of the request property `template`
  - removed the enum value `reminder3` of the request property `template`
  - removed the enum value `reminder_endless` of the request property `template`
  - removed the enum value `statement` of the request property `template`
  - added the new `email_template_credit` enum value to the request property `template`
  - added the new `email_template_custom1` enum value to the request property `template`
  - added the new `email_template_custom2` enum value to the request property `template`
  - added the new `email_template_custom3` enum value to the request property `template`
  - added the new `email_template_invoice` enum value to the request property `template`
  - added the new `email_template_payment` enum value to the request property `template`
  - added the new `email_template_payment_partial` enum value to the request property `template`
  - added the new `email_template_purchase_order` enum value to the request property `template`
  - added the new `email_template_quote` enum value to the request property `template`
  - added the new `email_template_reminder1` enum value to the request property `template`
  - added the new `email_template_reminder2` enum value to the request property `template`
  - added the new `email_template_reminder3` enum value to the request property `template`
  - added the new `email_template_reminder_endless` enum value to the request property `template`
  - added the new `email_template_statement` enum value to the request property `template`
- **2024-11-23** `a80e474b5da3`: 1 breaking, 15 info
  - request property `template` was restricted to a list of enum values
  - added the new `credit` enum value to the request property `template`
  - added the new `custom1` enum value to the request property `template`
  - added the new `custom2` enum value to the request property `template`
  - added the new `custom3` enum value to the request property `template`
  - added the new `email_quote_template_reminder1` enum value to the request property `template`
  - added the new `invoice` enum value to the request property `template`
  - added the new `payment` enum value to the request property `template`
  - added the new `payment_partial` enum value to the request property `template`
  - added the new `purchase_order` enum value to the request property `template`
  - added the new `quote` enum value to the request property `template`
  - added the new `reminder1` enum value to the request property `template`
  - added the new `reminder2` enum value to the request property `template`
  - added the new `reminder3` enum value to the request property `template`
  - added the new `reminder_endless` enum value to the request property `template`
  - added the new `statement` enum value to the request property `template`
- **2024-06-06** `8e82a2bd77e0`: 1 breaking, 2 info
  - the response's body type changed from no type to `object` for status `default`
  - added the optional property `code` to the response with the `default` status
  - added the optional property `message` to the response with the `default` status
- **2024-06-05** `e61df65649e2`: 1 breaking, 2 warning
  - the response's body type changed from `object` to no type for status `default`
  - removed the optional property `code` from the response with the `default` status
  - removed the optional property `message` from the response with the `default` status
- **2024-03-07** `71171a40d629`: 5 breaking, 8 info
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `object` for status `401`
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `422`
  - the response's body type changed from no type to `object` for status `default`
  - added the optional property `code` to the response with the `default` status
  - added the optional property `errors` to the response with the `403` status
  - added the optional property `errors` to the response with the `422` status
  - added the optional property `html` to the response with the `200` status
  - added the optional property `message` to the response with the `401` status
  - added the optional property `message` to the response with the `403` status
  - added the optional property `message` to the response with the `422` status
  - added the optional property `message` to the response with the `default` status
- **2024-02-18** `88bbc1f38ff7`: 5 breaking, 8 warning
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `object` to no type for status `401`
  - the response's body type changed from `object` to no type for status `403`
  - the response's body type changed from `object` to no type for status `422`
  - the response's body type changed from `object` to no type for status `default`
  - removed the optional property `code` from the response with the `default` status
  - removed the optional property `errors` from the response with the `403` status
  - removed the optional property `errors` from the response with the `422` status
  - removed the optional property `html` from the response with the `200` status
  - removed the optional property `message` from the response with the `401` status
  - removed the optional property `message` from the response with the `403` status
  - removed the optional property `message` from the response with the `422` status
  - removed the optional property `message` from the response with the `default` status
- **2024-02-10** `4ad0fff44c6c`: 4 info
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `403`
  - added the media type `application/json` for the response with the status `422`
  - added the media type `application/json` for the response with the status `default`
- **2024-01-24** `9dab078a46b5`: 1 info
  - endpoint added
- **2024-01-20** `70cd94370516`: 1 breaking
  - api path removed without deprecation
- **2023-10-01** `464a36941b64`: 3 breaking, 1 info
  - the request property `entity` became required
  - the request property `entity_id` became required
  - the request property `template` became required
  - added the new optional request property `cc_email`
- **2023-07-08** `627936439128`: 4 breaking
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `403`
  - removed the media type `application/json` for the response with the status `422`
  - removed the media type `application/json` for the response with the status `default`
- **2023-02-18** `ab767c581aef`: 2 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`

---

[Operation](https://skmtc.dev/invoiceninja/apis/invoice-ninja-api-reference/docs/api/v1/emails/post.md) - [API](https://skmtc.dev/invoiceninja/apis/invoice-ninja-api-reference.md) - [Page](https://skmtc.dev/invoiceninja/apis/invoice-ninja-api-reference/changes/api/v1/emails/post)
