---
title: "PUT /directMessages"
method: PUT
path: "/directMessages"
tags: ["messages"]
---

# PUT /directMessages

`PUT /directMessages`

Send a new direct message

## Request body

- object
  - `text` string, required — See the Rich Text page to learn more about formatting
  - `to` string, uuid, required — The user id of the receiver.
  - `from` string, uuid — The user id of the sender. Only an admin user can be chosen. If this field is not provided, the user that created the API key will be used.

## Response `204`

Successful response

## Other responses

- `400` — Invalid request body
- `401` — API Key is missing or invalid
- `404` — Could not find a user with a matching user id

---

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