---
title: "Create Notification"
method: POST
path: "/api/v3/notifications/events"
tags: ["Notifications"]
---

# Create Notification

`POST /api/v3/notifications/events`

Create a notification event and dispatch for delivery.

## Request body

- NotificationCreateRequest
  - `user_id` integer, required
  - `event_type` 'verification_approved' | 'verification_rejected' | 'record_removed' | 'record_edited' | 'auto_verify_failed' | 'skill_role_update' | 'xp_gain' | 'rank_up' | 'prestige' | 'mastery_earned' | 'lootbox_earned' | 'playtest_update' | 'map_edit_approved' | 'map_edit_rejected' | 'quest_complete' | 'quest_rotation' | 'quest_rival_mention', required
  - `title` string, required
  - `body` string, required
  - `discord_message` string, nullable
  - `metadata` object, nullable

## Response `201`

Document created, URL follows

- NotificationEventResponse
  - `id` integer, required
  - `user_id` integer, required
  - `event_type` 'verification_approved' | 'verification_rejected' | 'record_removed' | 'record_edited' | 'auto_verify_failed' | 'skill_role_update' | 'xp_gain' | 'rank_up' | 'prestige' | 'mastery_earned' | 'lootbox_earned' | 'playtest_update' | 'map_edit_approved' | 'map_edit_rejected' | 'quest_complete' | 'quest_rotation' | 'quest_rival_mention', required
  - `title` string, required
  - `body` string, required
  - `metadata` object, nullable
  - `created_at` string, required
  - `read_at` string, nullable
  - `dismissed_at` string, nullable

## Other responses

- `400` — Bad request syntax or unsupported method

---

[API](https://skmtc.net/genji/apis/genji-shimada-api.md) · [All operations](https://skmtc.net/genji/apis/genji-shimada-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/genji/genji-shimada-api/versions/6db12055b305/schema)