Creates an organization-wide notification config. settings names one or more public types. Destinations are emails, slackChannels, and teamsChannels arrays. The response returns those three arrays. A channel that a subscribed type does not support is 422 customers.channel_not_supported. A Teams destination on a type that supports Teams is 422 validation_failed when the tenant has no Teams entitlement.
Requires the settings (Manage settings) permission.
The Idempotency-Key header is required. The same key and the same body replay the stored success. A different body is 422 idempotency_key_reused. A 5xx response may leave the key reserved, so a retry returns 409 until the original request is released or about 30 minutes pass. dryRun=true does not reserve the key. With dryRun=true the request goes through the same checks as a real create and returns 200 with X-Dry-Run: true and null identity fields (id, createTime, updateTime, etag) without creating anything.
Reads are immediately consistent. After a 201, a GET of that notification returns the created config.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||