--- title: Create Silences --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Alerting](https://developers.cloudflare.com/api/go/resources/alerting) [Silences](https://developers.cloudflare.com/api/go/resources/alerting/subresources/silences) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create Silences client.Alerting.Silences.New(ctx, params) (\*[SilenceNewResponse](), error) POST/accounts/{account\_id}/alerting/v3/silences Creates a new silence for an account. ##### 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 SilenceNewParams AccountID param.Field\[string] Path param: The account id maxLength32 Link to this property
Body param.Field\[\[]SilenceNewParamsBody] Body param EndTime stringOptional When the silence ends. Link to this property PolicyID stringOptional The unique identifier of a notification policy maxLength32 Link to this property StartTime stringOptional When the silence starts. Link to this property
Link to this property
[Link to this property](<#(resource)%20alerting.silences%20%3E%20(method)%20create%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type SilenceNewResponse struct{…}
Errors \[]SilenceNewResponseError Message string Link to this property Code int64Optional minimum1000 Link to this property
Link to this property
Messages \[]SilenceNewResponseMessage Message string Link to this property Code int64Optional minimum1000 Link to this property
Link to this property Success SilenceNewResponseSuccess Whether the API call was successful Link to this property
[Link to this property](<#(resource)%20alerting.silences%20%3E%20(model)%20SilenceNewResponse%20%3E%20(schema)>) ### Create Silences 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"), ) silence, err := client.Alerting.Silences.New(context.TODO(), alerting.SilenceNewParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), Body: []alerting.SilenceNewParamsBody{alerting.SilenceNewParamsBody{ }}, }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", silence.Errors) } ``` 200 example ``` { "errors": [ { "message": "message", "code": 1000 } ], "messages": [ { "message": "message", "code": 1000 } ], "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "message": "message", "code": 1000 } ], "messages": [ { "message": "message", "code": 1000 } ], "success": true } ```