---
title: "Create Portfolio Item Notification Policy"
method: POST
path: "/portfolio/items/{item_id}/notification_policies"
tags: ["Portfolio Monitoring"]
---

# Create Portfolio Item Notification Policy

`POST /portfolio/items/{item_id}/notification_policies`

Create a notification policy for a portfolio item.

## Path parameters

- `item_id` string, uuid, required

## Request body

- V1CreateNotificationPolicyRequest — Request model for creating a notification policy.
  - `type` string, required — The type of notification policy (email, slack, webhook).
  - `name` string, required — The name of the notification policy.
  - `enabled` boolean — Whether the notification policy should be enabled.
  - `cadence` 'daily' | 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'biannually' | 'annually', required — The cadence of monitoring.
  - `attributes` V1NotifiableAttributes[] — List of attributes to notify on (officers, alternative_names).
  - `recipients` string[] — List of email recipients for email notification policies.

## Response `201`

Response

- V1NotificationPolicyResponse — Represents a notification policy response.
  - `id` string, uuid, required — The unique identifier of the notification policy.
  - `type` string, required — The type of notification policy (email, slack, webhook).
  - `name` string, required — The name of the notification policy.
  - `group_id` string, uuid, nullable — The unique identifier of the portfolio group (if applicable).
  - `item_id` string, uuid, nullable — The unique identifier of the portfolio item (if applicable).
  - `enabled` boolean, required — Whether the notification policy is enabled.
  - `cadence` 'daily' | 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'biannually' | 'annually', required — The cadence of monitoring.
  - `last_run_at` string, date-time, nullable — When the notification policy was last executed.
  - `next_run_on` string, date, nullable — When the notification policy is scheduled to run next.
  - `attributes` V1NotifiableAttributes[] — List of attributes to notify on (officers, alternative_names).
  - `recipients` string[] — List of email recipients for email notification policies.
  - `created_at` string, date-time, required — When the notification policy was created.
  - `updated_at` string, date-time, nullable — When the notification policy was last updated.

## Other responses

- `422` — Validation Error

---

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