---
title: "POST /messages/notifications:send"
method: POST
path: "/messages/notifications:send"
tags: ["Notifications"]
---

# POST /messages/notifications:send

`POST /messages/notifications:send`

Sends a notification message from Business to User.

## Query parameters

- `api-version` string, required

## Headers

- `Repeatability-Request-ID` string
- `Repeatability-First-Sent` string, date-time
- `x-ms-client-request-id` string, uuid

## Request body

- NotificationContent — Details of the message to send.
  - `channelRegistrationId` string, uuid, required — Universally Unique Identifier
  - `to` string[], required — The native external platform user identifiers of the recipient.
  - `kind` 'text' | 'image' | 'image_v0' | 'document' | 'video' | 'audio' | 'template' | 'sticker' | 'reaction' | 'interactive', required — The type of message.

## Response `202`

The request has been accepted for processing, but processing has not yet completed.

- SendMessageResult — Result of the send message operation.
  - `receipts` MessageReceipt[], required — Receipts of the send message operation.
    - `messageId` string, required — The message id.
    - `to` string, required — The native external platform user identifier of the recipient.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/communication-messages.md) · [All operations](https://skmtc.net/azure/apis/communication-messages/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/communication-messages/revisions/ec11c913a0e6/schema)