---
title: "Send Templated Email"
method: POST
path: "/v1/email/templates/{name}/send"
tags: ["Email"]
---

# Send Templated Email

`POST /v1/email/templates/{name}/send`

## Request

- Base URL: `https://api.bluehive.com`
- URL: `https://api.bluehive.com/v1/email/templates/{name}/send`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bluehive-health/apis/bluehive-api/docs/v1/email/templates/:name/send/post.ts> (a function with typed inputs; its response is checked against the schema)

Send an email using a registered template. Internal use only.

## Path parameters

- `name` string, required

## Request body

- object
  - `to` string[], required: Array of recipient email addresses
  - `variables` object, required: Template variables to interpolate

## Response `200`

Default Response

- object
  - `success` boolean, required: True if all emails were sent successfully, false if any failed
  - `statuses` object[], required: Status for each recipient
    - `recipient` string, required: Recipient email address
    - `emailToken` unknown, required
    - `success` boolean, required: Whether this email was sent successfully
  - `templateUsed` string, required: Name of the template used

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `500`: Default Response

## Changes

- **2026-10-16** `a8bcbdf02e33`: 1 warning
  - removed the request property `subject`
- **2026-03-17** `4abf46539e83`: 1 breaking
  - added the new required request property `subject`
- **2026-02-18** `efcb45ec0e67`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bluehive-health/apis/bluehive-api/changes/v1/email/templates/:name/send/post.md)

---

[API](https://skmtc.dev/bluehive-health/apis/bluehive-api.md) - [All operations](https://skmtc.dev/bluehive-health/apis/bluehive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluehive-health/apis/bluehive-api/revisions/a8bcbdf02e33?raw)