---
title: "Send an email for an order"
method: POST
path: "/shop/orders/{orderId}/emails"
tags: ["Orders"]
---

# Send an email for an order

`POST /shop/orders/{orderId}/emails`

Send an email to the customer for an order. The `type` field selects which
templated mailable is rendered — for example `BookingConfirmation` or
`BookingReminder`. The list of available types is determined by the
mailables configured in the application.

To render the email without actually sending it, use the
[Preview an order email](#operation/createOrderEmailPreview) endpoint
instead.

## Request body

- object
  - `type` string, required — The mailable type to send. This selects the underlying template; available types depend on the organisation's configured mailables.
  - `content` string — Optional custom message body to inject into the template. HTML is not permitted — submit plain text only.
  - `params` object — Additional template parameters to pass through to the mailable — the available keys depend on the chosen `type`.

## Response `201`

The email message was successfully sent.

- object
  - `data` OrderEmailSummary, required — A summary of an email message related to an order — including delivery, open and bounce status. Use the [Retrieve an order email](#operation/getOrderEmail) endpoint to fetch the full rendered HTML body.
    - `id` string, object-id, required — The ID of the email message.
    - `organisation_id` string, uuid, required — The ID of the organisation the email message belongs to.
    - `site_id` string, uuid, required — The ID of the site the email message belongs to.
    - `customer_id` string, uuid, nullable — The ID of the customer the email message was sent to, if known.
    - `basket_id` string, object-id, required — The ID of the order (basket) this email message is attached to.
    - `from` string, nullable — The "from" address that sent the email.
    - `to` string[], required — The list of recipients of the email message.
    - `cc` string[], nullable — The list of CC recipients of the email message.
    - `bcc` string[], nullable — The list of BCC recipients of the email message.
    - `subject` string, required — The subject line of the email message.
    - `type` string, required — The type of email message — typically maps to a templated message class such as `BookingConfirmation` or `BookingReminder`.
    - `created_at` string, date-time, nullable — The date and time the email message record was created.
    - `sent_at` string, date-time, nullable — The date and time the email message was sent to the upstream provider.
    - `delivered_at` string, date-time, nullable — The date and time the email message was reported as delivered.
    - `opened` boolean, required — Whether the recipient has opened the email at least once.
    - `bounced` boolean, required — Whether the email message bounced.

## Other responses

- `400` — The request failed.
- `404` — The resource couldn't be found
- `422` — The request didn't pass validation

---

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