---
title: "Send email"
method: POST
path: "/emails/send-email"
tags: ["Emails"]
---

# Send email

`POST /emails/send-email`

Send an email to a list of users (user_ids), all users (all_users), or arbitrary email addresses (emails). The content field should contain either {html} for HTML emails, {template_id, variables} for template-based emails, or {draft_id} for a draft email.

## Response `200`

Successful response

- object
  - `results` object[], required
    - `user_id` string
    - `email` string

## Changes

> 25 revisions in range; 2 could not be searched.

- **2026-07-02** `918618e43de1` — 1 breaking, 1 info
  - the response property `results/items/user_id` became optional for the status `200`
  - added the optional property `results/items/email` to the response with the `200` status

[Change history](https://skmtc.dev/hexclave/apis/hexclave-rest-api-3/changes/emails/send-email/post.md)

---

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