---
title: "POST /mail"
method: POST
path: "/mail"
tags: ["mail"]
---

# POST /mail

`POST /mail`

Send bulk email

## Request body

- ReqPostMail
  - `addresses` string[]
  - `userIds` string[]
  - `subject` string, required
  - `body` string, required
  - `sendToAdmin` boolean

## Response `200`

Success send email

- ResPostMail
  - `successCount` integer, required
  - `failures` object[], required
    - `address` string, required
    - `error` string, required

## Other responses

- `400` — Validation error, etc.
- `403` — Authentication error, etc.
- `500` — System error, etc.

## Changes

- **2026-02-28** `121b726bff12` — 2 info
  - the security scope `infra` was added to the endpoint's security scheme `BearerAuth`
  - the security scope `admin` was removed from the endpoint's security scheme `BearerAuth`
- **2026-02-18** `b72945437756` — 2 info
  - added the new optional request property `userIds`
  - the request property `addresses` became optional
- **2025-12-29** `8f046f3f3a76` — 2 breaking
  - the `addresses` request property's minItems was increased to `1`
  - the `addresses/items/` request property type/format changed from `string`/`` to `string`/`email`
- **2025-12-16** `06534e92420a` — 1 info
  - endpoint added
- **2023-04-06** `f92abf0d64e8` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/sit-digicre/apis/digicore/changes/mail/post.md)

---

[API](https://skmtc.dev/sit-digicre/apis/digicore.md) · [All operations](https://skmtc.dev/sit-digicre/apis/digicore/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sit-digicre/digicore/revisions/6576c966d74e/schema)