---
title: "Create a notification"
method: POST
path: "/users/{user_guid}/notifications"
tags: ["notifications"]
---

# Create a notification

`POST /users/{user_guid}/notifications`

All notifications created through the API will be of notification type `API_NOTIFICATION`, channel `PUSH`, and will not be associated to an entity.  No other channels are supported.  This will only have an effect for clients using an MX mobile application.

## Query parameters

- `content` string, required
- `subject` string, required

## Response `200`

OK

- NotificationResponseBody
  - `notification` NotificationResponse
    - `guid` string
    - `content` string
    - `deep_link_guid` string
    - `delivered_at` unknown
    - `entity_guid` string
    - `has_been_delivered` boolean
    - `has_been_viewed` boolean
    - `notification_type` unknown
    - `subject` string
    - `channel` string

## Changes

> 50 revisions in range; 1 not diffed.

- **2025-11-05** `e74cd2b059b5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mx/apis/mx-platform-api/changes/users/:user_guid/notifications/post.md)

---

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