---
title: "Creates an organization spend alert."
method: POST
path: "/organization/spend_alerts"
tags: ["Spend alerts"]
---

# Creates an organization spend alert.

`POST /organization/spend_alerts`

## Request body

- CreateSpendAlertBody — Parameters for creating or updating a spend alert.
  - `threshold_amount` integer, required — The alert threshold amount, in cents.
  - `currency` 'USD', required — The currency for the threshold amount.
  - `interval` 'month', required — The time interval for evaluating spend against the threshold.
  - `notification_channel` SpendAlertNotificationChannel, required — Email notification settings for a spend alert.
    - `type` 'email', required — The notification channel type. Currently only `email` is supported.
    - `recipients` string[], required — Email addresses that receive the spend alert notification.
    - `subject_prefix` string, nullable — Optional subject prefix for alert emails.

## Response `200`

Organization spend alert created successfully.

- OrganizationSpendAlert — Represents a spend alert configured at the organization level.
  - `id` string, required — The identifier, which can be referenced in API endpoints.
  - `object` 'organization.spend_alert', required — The object type, which is always `organization.spend_alert`.
  - `threshold_amount` integer, required — The alert threshold amount, in cents.
  - `currency` 'USD', required — The currency for the threshold amount.
  - `interval` 'month', required — The time interval for evaluating spend against the threshold.
  - `notification_channel` SpendAlertNotificationChannel, required — Email notification settings for a spend alert.
    - `type` 'email', required — The notification channel type. Currently only `email` is supported.
    - `recipients` string[], required — Email addresses that receive the spend alert notification.
    - `subject_prefix` string, nullable — Optional subject prefix for alert emails.

---

[API](https://skmtc.net/openai/apis/openapi.md) · [All operations](https://skmtc.net/openai/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openai/openapi/revisions/fc45a2f64c0a/schema)