---
title: "Send a notification to a specific user"
method: POST
path: "/internal/notifications/send"
tags: ["notifications"]
---

# Send a notification to a specific user

`POST /internal/notifications/send`

Sends a notification to a specific user within the current tenant using internal authentication.

This endpoint is intended for backend-triggered notifications where the originating user JWT
may no longer be valid by the time the notification is sent. Default notifications require
recipient_user_uuid, title, and message. For a playbook_budget_exceeded notification,
provide playbook_run_uuid; the recipient and content are derived from the run.

## Request body

- object
  - `notification_kind` string — Optional notification kind. For 'playbook_budget_exceeded', playbook_run_uuid is required and recipient, title, and message are derived from the run.
  - `recipient_user_uuid` string — UUID of the user who should receive the notification. Required unless notification_kind is 'playbook_budget_exceeded'
  - `thread_uuid` string — UUID of the conversation thread to deep link to
  - `playbook_run_uuid` string — UUID of the playbook run. Required when notification_kind is 'playbook_budget_exceeded'
  - `title` string — Short title for the notification (2-3 words). Required unless notification_kind is 'playbook_budget_exceeded'
  - `message` string — Detailed message content. Required unless notification_kind is 'playbook_budget_exceeded'
  - `channel` string — Notification channel: 'slack', 'email', or 'auto'
  - `dedupe_key` string — Optional idempotency key to suppress duplicate notifications for the same recipient

## Other responses

- `400` — Bad Request - Invalid parameters or malformed request
- `401` — Unauthorized - Invalid or missing authentication
- `403` — Forbidden - User lacks permission to access this resource
- `404` — Not Found - Resource does not exist
- `422` — Unprocessable Entity - Invalid request parameters or validation errors
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error - Unexpected server error

## Changes

- **2026-08-28** `63a6f433ede5` — 4 info
  - added the new optional request property `notification_kind`
  - the request property `message` became optional
  - the request property `recipient_user_uuid` became optional
  - the request property `title` became optional

[Change history](https://skmtc.dev/rhythms/apis/rhythms-params-in-body/changes/internal/notifications/send/post.md)

---

[API](https://skmtc.dev/rhythms/apis/rhythms-params-in-body.md) · [All operations](https://skmtc.dev/rhythms/apis/rhythms-params-in-body/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rhythms/rhythms-params-in-body/revisions/925d5943c46b/schema)