Create Notification Policy / user - claimed, unclaimed (instead of total)
POST {{apiPath}}/environments/{{envID}}/notificationsPolicies
When you use the POST {{apiPath}}/environments/{{envID}}/notificationsPolicies endpoint and specify USER as the type along with the claimed and unclaimedfields (rather than using the total field), a policy is created with separate per-user limits for the number of notifications responded to per day and the number of notifications not responded to per day.
Prerequisites
- See Notifications and Notification Policies for important overview information.
| Property | Type | Required? |
|---|---|---|
default | Boolean | Optional |
name | String | Required |
quotas | Array | Required |
quotas\[\].type | String | Required |
quotas\[\].deliveryMethods | Array | Required |
quotas\[\].total | Integer | Required/Optional |
quotas\[\].claimed | Integer | Required/Optional |
quotas\[\].unclaimed | Integer | Required/Optional |
See the Notification policies data model for full property descriptions.
Request Body
{"name"=>"Per-User - used/not used - Notification Policy", "quotas"=>[{"type"=>"USER", "deliveryMethods"=>["SMS", "Voice"], "claimed"=>50, "unclaimed"=>50}], "default"=>false}
RESPONSES
status: Created
{"_links":{"self":{"href":"https://api.pingone.eu/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/notificationsPolicies/9ac09c18-27d9-477f-a338-3438cea37601"},"environment":{"href":"https://api.pingone.eu/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"}},"id":"9ac09c18-27d9-477f-a338-3438cea37601","environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"name":"Per-User - used/not used - Notification Policy","quotas":[{"type":"USER","deliveryMethods":["SMS","Voice"],"unclaimed":50,"claimed":50}],"updatedAt":"2022-05-15T09:22:40.966Z","createdAt":"2022-05-15T09:22:40.971Z","default":false}