---
title: "Create a new notification"
method: POST
path: "/v1/notifications"
tags: ["Notification"]
---

# Create a new notification

`POST /v1/notifications`

Create a new notification for a specific hub.

## Request body

- CreateNotification
  - `projectId` string, uuid, required
  - `webhookUrl` string, required
  - `description` string, required
  - `customHeaders` CreateNotificationSchemaHeader[]
    - `key` string, required
    - `value` string, required
  - `triggers` CreateTrigger[], required
    - `resource` string, required
    - `verb` string, required
  - `tables` string[]
  - `processes` string[]

## Response `200`

Successfully created the notification.

- object
  - `metadata` object
  - `data` Notification
    - `publicId` string, uuid, required
    - `user` SummaryUser
      - `firebaseUserId` string
      - `publicId` string, uuid
      - `name` string
      - `email` string
      - `profilePicture` string
    - `description` string, nullable
    - `actions` Action[], required
      - `publicId` string, uuid, required
      - `kind` string, required
      - `webhookUrl` string
      - `customHeaders` ActionHeaders[]
        - `key` string, required
        - `value` string, required
    - `triggers` Trigger[], required
      - `publicId` string, uuid, required
      - `resource` string, required
      - `verb` string, required
    - `processes` Document[]
      - `publicId` string, uuid
      - `name` string
    - `tables` Table1[]
      - `publicId` string, uuid
      - `name` string
      - `defaultViewId` string
    - `createdAt` string, date-time

## Other responses

- `403` — Unauthorized action - User is not an admin or owner.
- `404` — Hub not found.

---

[API](https://skmtc.net/morta-technology/apis/morta-api-reference.md) · [All operations](https://skmtc.net/morta-technology/apis/morta-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/morta-technology/morta-api-reference/revisions/9c58c1c1e7e8/schema)