---
title: "Create"
method: POST
path: "/v1/notifications"
---

# Create

`POST /v1/notifications`

Creates a trigger to send a notification to a customer or endpoint.

## Headers

- `x-user-secret-key` string, required
- `Content-Type` string, required

## Request body

- object
  - `type` string, required — Type of notification. Available values: 'webhook', 'email'
  - `destination` string, required — Where to send the notification. URL for webhook; email address for email.
  - `event` string, required — Event to trigger a notification
  - `subject` string — set subject of notification. Email notifications only
  - `transaction_only` boolean — If true, the payload of an event will include information on the transaction only. The rest fo the fields will be omitted.

## Response `200`

200

- object
  - `status` integer
  - `error` unknown
  - `resource` object
    - `type` string
    - `data` object
      - `event` string
      - `destination` string
      - `type` string
      - `_id` string
      - `transaction_only` boolean

## Other responses

- `400` — 400

---

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