Notifications

Create notification

POST/api/v1/notifications

Sends a notification directly to a specific user. Staff-only — used for manual, one-off communication outside the platform's automated notification triggers.

Requires Authorization

ADMIN, SUPPORT only

Authenticated action

Body parameters

`userId`stringrequired	Recipient's user ID.
`type`stringrequired	One of the notification types.
`title`stringrequired
`body`stringrequired
`data`object	Arbitrary metadata delivered alongside the notification.

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/notifications \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "userId": "<userId>",
  "type": "<type>",
  "title": "<title>",
  "body": "<body>",
  "data": {}
}'

201Example response

{
  "success": true,
  "data": {
    "id": "notif_1a2b3c",
    "userId": "3f2a1c9e",
    "type": "ORDER_STATUS",
    "title": "Votre commande a été acceptée",
    "body": "Boutique Aline vient d'accepter votre commande.",
    "data": {
      "orderId": "ord_5e6f7a"
    },
    "isRead": false,
    "createdAt": "2026-02-15T09:10:00.000Z"
  }
}