--- title: Create a Notification policy --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Alerting](https://developers.cloudflare.com/api/go/resources/alerting) [Policies](https://developers.cloudflare.com/api/go/resources/alerting/subresources/policies) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create a Notification policy client.Alerting.Policies.New(ctx, params) (\*[PolicyNewResponse](), error) POST/accounts/{account\_id}/alerting/v3/policies Creates a new Notification policy. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Notifications Write``Account Settings Write` ##### ParametersExpand Collapse
params PolicyNewParams AccountID param.Field\[string] Path param: The account id maxLength32 Link to this property
AlertType param.Field\[PolicyNewParamsAlertType] Body param: 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. const PolicyNewParamsAlertTypeAbuseReportAlert PolicyNewParamsAlertType = "abuse\_report\_alert" Link to this property const PolicyNewParamsAlertTypeAccessCustomCertificateExpirationType PolicyNewParamsAlertType = "access\_custom\_certificate\_expiration\_type" Link to this property const PolicyNewParamsAlertTypeAdvancedDDoSAttackL4Alert PolicyNewParamsAlertType = "advanced\_ddos\_attack\_l4\_alert" Link to this property const PolicyNewParamsAlertTypeAdvancedDDoSAttackL7Alert PolicyNewParamsAlertType = "advanced\_ddos\_attack\_l7\_alert" Link to this property const PolicyNewParamsAlertTypeAdvancedHTTPAlertError PolicyNewParamsAlertType = "advanced\_http\_alert\_error" Link to this property const PolicyNewParamsAlertTypeBGPHijackNotification PolicyNewParamsAlertType = "bgp\_hijack\_notification" Link to this property const PolicyNewParamsAlertTypeBillingUsageAlert PolicyNewParamsAlertType = "billing\_usage\_alert" Link to this property const PolicyNewParamsAlertTypeBlockNotificationBlockRemoved PolicyNewParamsAlertType = "block\_notification\_block\_removed" Link to this property const PolicyNewParamsAlertTypeBlockNotificationNewBlock PolicyNewParamsAlertType = "block\_notification\_new\_block" Link to this property const PolicyNewParamsAlertTypeBlockNotificationReviewRejected PolicyNewParamsAlertType = "block\_notification\_review\_rejected" Link to this property const PolicyNewParamsAlertTypeBotTrafficBasicAlert PolicyNewParamsAlertType = "bot\_traffic\_basic\_alert" Link to this property const PolicyNewParamsAlertTypeBrandProtectionAlert PolicyNewParamsAlertType = "brand\_protection\_alert" Link to this property const PolicyNewParamsAlertTypeBrandProtectionDigest PolicyNewParamsAlertType = "brand\_protection\_digest" Link to this property const PolicyNewParamsAlertTypeClickhouseAlertFwAnomaly PolicyNewParamsAlertType = "clickhouse\_alert\_fw\_anomaly" Link to this property const PolicyNewParamsAlertTypeClickhouseAlertFwEntAnomaly PolicyNewParamsAlertType = "clickhouse\_alert\_fw\_ent\_anomaly" Link to this property const PolicyNewParamsAlertTypeCloudforceOneRequestNotification PolicyNewParamsAlertType = "cloudforce\_one\_request\_notification" Link to this property const PolicyNewParamsAlertTypeCNIMaintenanceNotification PolicyNewParamsAlertType = "cni\_maintenance\_notification" Link to this property const PolicyNewParamsAlertTypeCustomAnalytics PolicyNewParamsAlertType = "custom\_analytics" Link to this property const PolicyNewParamsAlertTypeCustomBotDetectionAlert PolicyNewParamsAlertType = "custom\_bot\_detection\_alert" Link to this property const PolicyNewParamsAlertTypeCustomSSLCertificateEventType PolicyNewParamsAlertType = "custom\_ssl\_certificate\_event\_type" Link to this property const PolicyNewParamsAlertTypeDedicatedSSLCertificateEventType PolicyNewParamsAlertType = "dedicated\_ssl\_certificate\_event\_type" Link to this property const PolicyNewParamsAlertTypeDeviceConnectivityAnomalyAlert PolicyNewParamsAlertType = "device\_connectivity\_anomaly\_alert" Link to this property const PolicyNewParamsAlertTypeDosAttackL4 PolicyNewParamsAlertType = "dos\_attack\_l4" Link to this property const PolicyNewParamsAlertTypeDosAttackL7 PolicyNewParamsAlertType = "dos\_attack\_l7" Link to this property const PolicyNewParamsAlertTypeExpiringServiceTokenAlert PolicyNewParamsAlertType = "expiring\_service\_token\_alert" Link to this property const PolicyNewParamsAlertTypeFailingLogpushJobDisabledAlert PolicyNewParamsAlertType = "failing\_logpush\_job\_disabled\_alert" Link to this property const PolicyNewParamsAlertTypeFbmAutoAdvertisement PolicyNewParamsAlertType = "fbm\_auto\_advertisement" Link to this property const PolicyNewParamsAlertTypeFbmDosdAttack PolicyNewParamsAlertType = "fbm\_dosd\_attack" Link to this property const PolicyNewParamsAlertTypeFbmVolumetricAttack PolicyNewParamsAlertType = "fbm\_volumetric\_attack" Link to this property const PolicyNewParamsAlertTypeHealthCheckStatusNotification PolicyNewParamsAlertType = "health\_check\_status\_notification" Link to this property const PolicyNewParamsAlertTypeHostnameAopCustomCertificateExpirationType PolicyNewParamsAlertType = "hostname\_aop\_custom\_certificate\_expiration\_type" Link to this property const PolicyNewParamsAlertTypeHTTPAlertEdgeError PolicyNewParamsAlertType = "http\_alert\_edge\_error" Link to this property const PolicyNewParamsAlertTypeHTTPAlertOriginError PolicyNewParamsAlertType = "http\_alert\_origin\_error" Link to this property const PolicyNewParamsAlertTypeImageNotification PolicyNewParamsAlertType = "image\_notification" Link to this property const PolicyNewParamsAlertTypeImageResizingNotification PolicyNewParamsAlertType = "image\_resizing\_notification" Link to this property const PolicyNewParamsAlertTypeIncidentAlert PolicyNewParamsAlertType = "incident\_alert" Link to this property const PolicyNewParamsAlertTypeLoadBalancingHealthAlert PolicyNewParamsAlertType = "load\_balancing\_health\_alert" Link to this property const PolicyNewParamsAlertTypeLoadBalancingPoolEnablementAlert PolicyNewParamsAlertType = "load\_balancing\_pool\_enablement\_alert" Link to this property const PolicyNewParamsAlertTypeLogoMatchAlert PolicyNewParamsAlertType = "logo\_match\_alert" Link to this property const PolicyNewParamsAlertTypeMagicTunnelHealthCheckEvent PolicyNewParamsAlertType = "magic\_tunnel\_health\_check\_event" Link to this property const PolicyNewParamsAlertTypeMagicWANTunnelHealth PolicyNewParamsAlertType = "magic\_wan\_tunnel\_health" Link to this property const PolicyNewParamsAlertTypeMaintenanceEventNotification PolicyNewParamsAlertType = "maintenance\_event\_notification" Link to this property const PolicyNewParamsAlertTypeMTLSCertificateStoreCertificateExpirationType PolicyNewParamsAlertType = "mtls\_certificate\_store\_certificate\_expiration\_type" Link to this property const PolicyNewParamsAlertTypePagesEventAlert PolicyNewParamsAlertType = "pages\_event\_alert" Link to this property const PolicyNewParamsAlertTypeRadarNotification PolicyNewParamsAlertType = "radar\_notification" Link to this property const PolicyNewParamsAlertTypeRealOriginMonitoring PolicyNewParamsAlertType = "real\_origin\_monitoring" Link to this property const PolicyNewParamsAlertTypeScriptmonitorAlertNewCodeChangeDetections PolicyNewParamsAlertType = "scriptmonitor\_alert\_new\_code\_change\_detections" Link to this property const PolicyNewParamsAlertTypeScriptmonitorAlertNewHosts PolicyNewParamsAlertType = "scriptmonitor\_alert\_new\_hosts" Link to this property const PolicyNewParamsAlertTypeScriptmonitorAlertNewMaliciousHosts PolicyNewParamsAlertType = "scriptmonitor\_alert\_new\_malicious\_hosts" Link to this property const PolicyNewParamsAlertTypeScriptmonitorAlertNewMaliciousScripts PolicyNewParamsAlertType = "scriptmonitor\_alert\_new\_malicious\_scripts" Link to this property const PolicyNewParamsAlertTypeScriptmonitorAlertNewMaliciousURL PolicyNewParamsAlertType = "scriptmonitor\_alert\_new\_malicious\_url" Link to this property const PolicyNewParamsAlertTypeScriptmonitorAlertNewMaxLengthResourceURL PolicyNewParamsAlertType = "scriptmonitor\_alert\_new\_max\_length\_resource\_url" Link to this property const PolicyNewParamsAlertTypeScriptmonitorAlertNewResources PolicyNewParamsAlertType = "scriptmonitor\_alert\_new\_resources" Link to this property const PolicyNewParamsAlertTypeSecondaryDNSAllPrimariesFailing PolicyNewParamsAlertType = "secondary\_dns\_all\_primaries\_failing" Link to this property const PolicyNewParamsAlertTypeSecondaryDNSPrimariesFailing PolicyNewParamsAlertType = "secondary\_dns\_primaries\_failing" Link to this property const PolicyNewParamsAlertTypeSecondaryDNSWarning PolicyNewParamsAlertType = "secondary\_dns\_warning" Link to this property const PolicyNewParamsAlertTypeSecondaryDNSZoneSuccessfullyUpdated PolicyNewParamsAlertType = "secondary\_dns\_zone\_successfully\_updated" Link to this property const PolicyNewParamsAlertTypeSecondaryDNSZoneValidationWarning PolicyNewParamsAlertType = "secondary\_dns\_zone\_validation\_warning" Link to this property const PolicyNewParamsAlertTypeSecurityInsightsAlert PolicyNewParamsAlertType = "security\_insights\_alert" Link to this property const PolicyNewParamsAlertTypeSentinelAlert PolicyNewParamsAlertType = "sentinel\_alert" Link to this property const PolicyNewParamsAlertTypeStreamLiveNotifications PolicyNewParamsAlertType = "stream\_live\_notifications" Link to this property const PolicyNewParamsAlertTypeSyntheticTestLatencyAlert PolicyNewParamsAlertType = "synthetic\_test\_latency\_alert" Link to this property const PolicyNewParamsAlertTypeSyntheticTestLowAvailabilityAlert PolicyNewParamsAlertType = "synthetic\_test\_low\_availability\_alert" Link to this property const PolicyNewParamsAlertTypeTrafficAnomaliesAlert PolicyNewParamsAlertType = "traffic\_anomalies\_alert" Link to this property const PolicyNewParamsAlertTypeTunnelHealthEvent PolicyNewParamsAlertType = "tunnel\_health\_event" Link to this property const PolicyNewParamsAlertTypeTunnelUpdateEvent PolicyNewParamsAlertType = "tunnel\_update\_event" Link to this property const PolicyNewParamsAlertTypeUniversalSSLEventType PolicyNewParamsAlertType = "universal\_ssl\_event\_type" Link to this property const PolicyNewParamsAlertTypeWebAnalyticsMetricsUpdate PolicyNewParamsAlertType = "web\_analytics\_metrics\_update" Link to this property const PolicyNewParamsAlertTypeZoneAopCustomCertificateExpirationType PolicyNewParamsAlertType = "zone\_aop\_custom\_certificate\_expiration\_type" Link to this property
Link to this property Enabled param.Field\[bool] Body param: Whether or not the Notification policy is enabled. Link to this property Mechanisms param.Field\[Mechanism] Body param: List of IDs that will be used when dispatching a notification. IDs for email type will be the email address. Link to this property Name param.Field\[string] Body param: Name of the policy. Link to this property AlertInterval param.Field\[string]Optional Body param: Optional specification of how often to re-alert from the same incident, not support on all alert types. Link to this property Description param.Field\[string]Optional Body param: Optional description for the Notification policy. Link to this property Filters param.Field\[PolicyFilter]Optional Body param: 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
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(method)%20create%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type PolicyNewResponse struct{…} ID stringOptional UUID maxLength32 Link to this property
[Link to this property](<#(resource)%20alerting.policies%20%3E%20(model)%20PolicyNewResponse%20%3E%20(schema)>) ### Create a Notification policy Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/alerting" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) policy, err := client.Alerting.Policies.New(context.TODO(), alerting.PolicyNewParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), AlertType: cloudflare.F(alerting.PolicyNewParamsAlertTypeUniversalSSLEventType), Enabled: cloudflare.F(true), Mechanisms: cloudflare.F(alerting.MechanismParam{ }), Name: cloudflare.F("SSL Notification Event Policy"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", policy.ID) } ``` 200 example ``` { "errors": [ { "message": "message", "code": 1000 } ], "messages": [ { "message": "message", "code": 1000 } ], "success": true, "result": { "id": "f174e90afafe4643bbbc4a0ed4fc8415" } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "message": "message", "code": 1000 } ], "messages": [ { "message": "message", "code": 1000 } ], "success": true, "result": { "id": "f174e90afafe4643bbbc4a0ed4fc8415" } } ```