---
title: "Send a Mail"
method: POST
path: "/messages"
tags: ["Message"]
---

# Send a Mail

`POST /messages`

Send to multiple recipients and save to db, admin only.

## Request body

- MessageCreateModel
  - `description` string — MessageTypeMail
  - `recipients` integer[], required

## Response `201`

Created

- ModelsMessage
  - `code` 'favorite' | 'reply' | 'mention' | 'modify' | 'permission' | 'report' | 'report_dealt' | 'mail' | 'sensitive'
  - `data` unknown
  - `description` string
  - `has_read` boolean — 兼容旧版, 永远为false，以MessageUser的HasRead为准
  - `id` integer
  - `message` string
  - `message_id` integer — 兼容旧版 id
  - `related_floor_id` integer
  - `related_hole_id` integer
  - `time_created` string
  - `time_updated` string
  - `url` string

---

[API](https://skmtc.net/opentreehole/apis/open-tree-hole.md) · [All operations](https://skmtc.net/opentreehole/apis/open-tree-hole/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opentreehole/open-tree-hole/versions/a91f11ffe9a4/schema)