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

# POST /notifications/

`POST /notifications/`

## Query parameters

- `format` 'json' | 'xlsx'

## Request body

- Notification
  - `id` string, uuid, required
  - `url` string, uri, required
  - `method` 'app' | 'email' | 'sms', required
  - `task` string, uri, required
  - `template` string, uri, nullable
  - `event` union
    - 'create' | 'assign' | 'unassign' | 'reject' | 'accept' | 'unaccept' | 'transit' | 'activate' | 'complete' | 'fail' | 'cancel' | 'assignee_near' | 'assignee_away' | 'updated'
    - ''
    - unknown
  - `state` union
    - 'unassigned' | 'assigned' | 'accepted' | 'transit' | 'active' | 'completed' | 'failed' | 'cancelled'
    - ''
    - unknown
  - `assignee_proximity` union
    - 'away' | 'near'
    - ''
    - unknown
  - `recipient` union
    - 'account' | 'assignee' | 'orderer' | 'contact' | 'client'
    - ''
    - unknown
  - `emails` string[], nullable
  - `phones` string[]
  - `message` string
  - `add_tracking_link` boolean
  - `sms_count` integer, required
  - `sent_at` string, date-time, nullable
  - `via_app` boolean, required
  - `via_email` boolean, required
  - `via_sms` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Response `201`

## Changes

- **2026-07-13** `2557a8fec764` — 2 info
  - media type `application/json; version=2.4.12` was changed to `application/json; version=2.4.13` for the response status `201`
  - media type `application/xlsx; version=2.4.12` was changed to `application/xlsx; version=2.4.13` for the response status `201`
- **2022-10-13** `b89c1b3e6d09` — 2 info
  - media type `application/json; version=2.4.11` was changed to `application/json; version=2.4.12` for the response status `201`
  - media type `application/xlsx; version=2.4.11` was changed to `application/xlsx; version=2.4.12` for the response status `201`
- **2022-09-20** `2823b16250b7` — 2 info
  - media type `application/json; version=2.4.10` was changed to `application/json; version=2.4.11` for the response status `201`
  - media type `application/xlsx; version=2.4.10` was changed to `application/xlsx; version=2.4.11` for the response status `201`
- **2022-09-16** `025494408062` — 2 info
  - media type `application/json; version=2.4.5` was changed to `application/json; version=2.4.10` for the response status `201`
  - media type `application/xlsx; version=2.4.5` was changed to `application/xlsx; version=2.4.10` for the response status `201`
- **2022-09-08** `486e2fd12f8f` — 2 info
  - media type `application/json; version=2.3.5` was changed to `application/json; version=2.4.5` for the response status `201`
  - media type `application/xlsx; version=2.3.5` was changed to `application/xlsx; version=2.4.5` for the response status `201`

[Full history](https://skmtc.dev/oeklo/apis/gsmtasks-project-api/changes/notifications/post.md)

---

[API](https://skmtc.dev/oeklo/apis/gsmtasks-project-api.md) · [All operations](https://skmtc.dev/oeklo/apis/gsmtasks-project-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oeklo/gsmtasks-project-api/revisions/2557a8fec764/schema)