--- title: Policies --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Alerting](https://developers.cloudflare.com/api/resources/alerting) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Policies ##### [List Notification policies](https://developers.cloudflare.com/api/resources/alerting/subresources/policies/methods/list) GET/accounts/{account\_id}/alerting/v3/policies ##### [Get a Notification policy](https://developers.cloudflare.com/api/resources/alerting/subresources/policies/methods/get) GET/accounts/{account\_id}/alerting/v3/policies/{policy\_id} ##### [Create a Notification policy](https://developers.cloudflare.com/api/resources/alerting/subresources/policies/methods/create) POST/accounts/{account\_id}/alerting/v3/policies ##### [Update a Notification policy](https://developers.cloudflare.com/api/resources/alerting/subresources/policies/methods/update) PUT/accounts/{account\_id}/alerting/v3/policies/{policy\_id} ##### [Delete a Notification policy](https://developers.cloudflare.com/api/resources/alerting/subresources/policies/methods/delete) DELETE/accounts/{account\_id}/alerting/v3/policies/{policy\_id} ##### ModelsExpand Collapse
Mechanism object {email, pagerduty, webhooks } List of IDs that will be used when dispatching a notification. IDs for email type will be the email address.
email: optional array of object {id } id: optional string The email address Link to this property
Link to this property
pagerduty: optional array of object {id } id: optional string UUID maxLength32 Link to this property
Link to this property
webhooks: optional array of object {id } id: optional string UUID maxLength32 Link to this property
Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(model)%20mechanism%20%3E%20(schema)>)
Policy object {id, alert\_interval, alert\_type, 7 more } id: optional string The unique identifier of a notification policy maxLength32 Link to this property alert\_interval: optional string Optional specification of how often to re-alert from the same incident, not support on all alert types. Link to this property
alert\_type: optional "abuse\_report\_alert"or "access\_custom\_certificate\_expiration\_type"or "advanced\_ddos\_attack\_l4\_alert"or 66 more Refers to which event will trigger a Notification dispatch. You can use the endpoint to get available alert types which then will give you a list of possible values. One of the following: "abuse\_report\_alert" Link to this property "access\_custom\_certificate\_expiration\_type" Link to this property "advanced\_ddos\_attack\_l4\_alert" Link to this property "advanced\_ddos\_attack\_l7\_alert" Link to this property "advanced\_http\_alert\_error" Link to this property "bgp\_hijack\_notification" Link to this property "billing\_usage\_alert" Link to this property "block\_notification\_block\_removed" Link to this property "block\_notification\_new\_block" Link to this property "block\_notification\_review\_rejected" Link to this property "bot\_traffic\_basic\_alert" Link to this property "brand\_protection\_alert" Link to this property "brand\_protection\_digest" Link to this property "clickhouse\_alert\_fw\_anomaly" Link to this property "clickhouse\_alert\_fw\_ent\_anomaly" Link to this property "cloudforce\_one\_request\_notification" Link to this property "cni\_maintenance\_notification" Link to this property "custom\_analytics" Link to this property "custom\_bot\_detection\_alert" Link to this property "custom\_ssl\_certificate\_event\_type" Link to this property "dedicated\_ssl\_certificate\_event\_type" Link to this property "device\_connectivity\_anomaly\_alert" Link to this property "dos\_attack\_l4" Link to this property "dos\_attack\_l7" Link to this property "expiring\_service\_token\_alert" Link to this property "failing\_logpush\_job\_disabled\_alert" Link to this property "fbm\_auto\_advertisement" Link to this property "fbm\_dosd\_attack" Link to this property "fbm\_volumetric\_attack" Link to this property "health\_check\_status\_notification" Link to this property "hostname\_aop\_custom\_certificate\_expiration\_type" Link to this property "http\_alert\_edge\_error" Link to this property "http\_alert\_origin\_error" Link to this property "image\_notification" Link to this property "image\_resizing\_notification" Link to this property "incident\_alert" Link to this property "load\_balancing\_health\_alert" Link to this property "load\_balancing\_pool\_enablement\_alert" Link to this property "logo\_match\_alert" Link to this property "magic\_tunnel\_health\_check\_event" Link to this property "magic\_wan\_tunnel\_health" Link to this property "maintenance\_event\_notification" Link to this property "mtls\_certificate\_store\_certificate\_expiration\_type" Link to this property "pages\_event\_alert" Link to this property "radar\_notification" Link to this property "real\_origin\_monitoring" Link to this property "scriptmonitor\_alert\_new\_code\_change\_detections" Link to this property "scriptmonitor\_alert\_new\_hosts" Link to this property "scriptmonitor\_alert\_new\_malicious\_hosts" Link to this property "scriptmonitor\_alert\_new\_malicious\_scripts" Link to this property "scriptmonitor\_alert\_new\_malicious\_url" Link to this property "scriptmonitor\_alert\_new\_max\_length\_resource\_url" Link to this property "scriptmonitor\_alert\_new\_resources" Link to this property "secondary\_dns\_all\_primaries\_failing" Link to this property "secondary\_dns\_primaries\_failing" Link to this property "secondary\_dns\_warning" Link to this property "secondary\_dns\_zone\_successfully\_updated" Link to this property "secondary\_dns\_zone\_validation\_warning" Link to this property "security\_insights\_alert" Link to this property "sentinel\_alert" Link to this property "stream\_live\_notifications" Link to this property "synthetic\_test\_latency\_alert" Link to this property "synthetic\_test\_low\_availability\_alert" Link to this property "traffic\_anomalies\_alert" Link to this property "tunnel\_health\_event" Link to this property "tunnel\_update\_event" Link to this property "universal\_ssl\_event\_type" Link to this property "web\_analytics\_metrics\_update" Link to this property "zone\_aop\_custom\_certificate\_expiration\_type" Link to this property
Link to this property created: optional string formatdate-time Link to this property description: optional string Optional description for the Notification policy. Link to this property enabled: optional boolean Whether or not the Notification policy is enabled. Link to this property filters: optional PolicyFilter { actions, affected\_asns, affected\_components, 41 more } Optional filters that allow you to be alerted only on a subset of events for that alert type based on some criteria. This is only available for select alert types. See alert type documentation for more details. Link to this property mechanisms: optional Mechanism { email, pagerduty, webhooks } List of IDs that will be used when dispatching a notification. IDs for email type will be the email address. Link to this property modified: optional string formatdate-time Link to this property name: optional string Name of the policy. Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(model)%20policy%20%3E%20(schema)>)
PolicyFilter object {actions, affected\_asns, affected\_components, 41 more } Optional filters that allow you to be alerted only on a subset of events for that alert type based on some criteria. This is only available for select alert types. See alert type documentation for more details. actions: optional array of string Usage depends on specific alert type Link to this property affected\_asns: optional array of string Used for configuring radar\_notification Link to this property affected\_components: optional array of string Used for configuring incident\_alert Link to this property affected\_locations: optional array of string Used for configuring radar\_notification Link to this property airport\_code: optional array of string Used for configuring maintenance\_event\_notification Link to this property alert\_trigger\_preferences: optional array of string Usage depends on specific alert type Link to this property alert\_trigger\_preferences\_value: optional array of string Usage depends on specific alert type Link to this property enabled: optional array of string Used for configuring load\_balancing\_pool\_enablement\_alert Link to this property environment: optional array of string Used for configuring pages\_event\_alert Link to this property event: optional array of string Used for configuring pages\_event\_alert Link to this property event\_source: optional array of string Used for configuring load\_balancing\_health\_alert Link to this property event\_type: optional array of string Usage depends on specific alert type Link to this property group\_by: optional array of string Usage depends on specific alert type Link to this property health\_check\_id: optional array of string Used for configuring health\_check\_status\_notification Link to this property
incident\_impact: optional array of "INCIDENT\_IMPACT\_NONE"or "INCIDENT\_IMPACT\_MINOR"or "INCIDENT\_IMPACT\_MAJOR"or "INCIDENT\_IMPACT\_CRITICAL" Used for configuring incident\_alert One of the following: "INCIDENT\_IMPACT\_NONE" Link to this property "INCIDENT\_IMPACT\_MINOR" Link to this property "INCIDENT\_IMPACT\_MAJOR" Link to this property "INCIDENT\_IMPACT\_CRITICAL" Link to this property
Link to this property input\_id: optional array of string Used for configuring stream\_live\_notifications Link to this property insight\_class: optional array of string Used for configuring security\_insights\_alert Link to this property limit: optional array of string Used for configuring billing\_usage\_alert Link to this property logo\_tag: optional array of string Used for configuring logo\_match\_alert Link to this property megabits\_per\_second: optional array of string Used for configuring advanced\_ddos\_attack\_l4\_alert Link to this property new\_health: optional array of string Used for configuring load\_balancing\_health\_alert Link to this property new\_status: optional array of string Used for configuring tunnel\_health\_event Link to this property packets\_per\_second: optional array of string Used for configuring advanced\_ddos\_attack\_l4\_alert Link to this property pool\_id: optional array of string Usage depends on specific alert type Link to this property pop\_names: optional array of string Usage depends on specific alert type Link to this property product: optional array of string Used for configuring billing\_usage\_alert Link to this property project\_id: optional array of string Used for configuring pages\_event\_alert Link to this property protocol: optional array of string Used for configuring advanced\_ddos\_attack\_l4\_alert Link to this property query\_tag: optional array of string Usage depends on specific alert type Link to this property requests\_per\_second: optional array of string Used for configuring advanced\_ddos\_attack\_l7\_alert Link to this property selectors: optional array of string Usage depends on specific alert type Link to this property services: optional array of string Used for configuring clickhouse\_alert\_fw\_ent\_anomaly Link to this property slo: optional array of string Usage depends on specific alert type Link to this property status: optional array of string Used for configuring health\_check\_status\_notification Link to this property target\_hostname: optional array of string Used for configuring advanced\_ddos\_attack\_l7\_alert Link to this property target\_ip: optional array of string Used for configuring advanced\_ddos\_attack\_l4\_alert Link to this property target\_zone\_name: optional array of string Used for configuring advanced\_ddos\_attack\_l7\_alert Link to this property token\_id: optional array of string Access service token IDs to include for expiring\_service\_token\_alert. Omit this property to include all current and future service tokens. Link to this property traffic\_exclusions: optional array of "security\_events" Used for configuring traffic\_anomalies\_alert Link to this property tunnel\_id: optional array of string Used for configuring tunnel\_health\_event Link to this property tunnel\_name: optional array of string Usage depends on specific alert type Link to this property type: optional array of string Usage depends on specific alert type Link to this property where: optional array of string Usage depends on specific alert type Link to this property zones: optional array of string Usage depends on specific alert type Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(model)%20policy_filter%20%3E%20(schema)>)
PolicyCreateResponse object {id } id: optional string UUID maxLength32 Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(model)%20policy_create_response%20%3E%20(schema)>)
PolicyUpdateResponse object {id } id: optional string UUID maxLength32 Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(model)%20policy_update_response%20%3E%20(schema)>)
PolicyDeleteResponse object {errors, messages, success, result\_info }
errors: array of object {message, code } message: string Link to this property code: optional number minimum1000 Link to this property
Link to this property
messages: array of object {message, code } message: string Link to this property code: optional number minimum1000 Link to this property
Link to this property success: true Whether the API call was successful Link to this property
result\_info: optional object {count, page, per\_page, total\_count } count: optional number Total number of results for the requested service Link to this property page: optional number Current page within paginated list of results Link to this property per\_page: optional number Number of results per page of results Link to this property total\_count: optional number Total results available without any search parameters Link to this property
Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(model)%20policy_delete_response%20%3E%20(schema)>)