Skip to main content
Version: 1.21.0

Escalations

Professional

This page is for administrators and developers building an endpoint to receive these events.

EasyLife 365 Identity sends this payload when an ownership rule escalates on an application: the owners were reminded, the reminders ran out, and the application still does not meet the rule. How to configure the webhook, and how it authenticates, is described in Overview.

HTTP request​

POST YourApiUrl
Content-Type: application/json
{
"eventType": "MinimumOwnersPolicyEscalation",
"appName": "Contoso Payroll",
"appObjectId": "8f4d0e7a-1234-1xw2x-yz34-9b2c5de61f08",
"escalationType": 1,
"policy": {
"pId": "fa2c0672-1234-1xw2x-yz34-aa09fc31672b",
"owSt": "escalate",
"owSta": "incompliant",
"owStCh": "2026-09-11T08:30:00Z"
},
"tenantId": "1840b34e-1234-1xw2x-yz34-0b7b58c49dc7"
}

Fields​

FieldDescription
eventTypeThe rule that escalated, as a readable name. Use this to route the event.
appNameThe display name of the application at the time of the escalation.
appObjectIdThe object ID of the application in Microsoft Entra ID. Use this to look the application up, because a display name can change.
escalationTypeThe same information as eventType, as a number. Retained for receivers built before eventType existed.
policyThe application's current policy state. See The policy object.
tenantIdThe Microsoft Entra ID tenant the application belongs to.

Event types​

eventTypeescalationTypeRule
MinimumOwnersPolicyEscalation1Minimum Application Owners
MinimumTechnicalOwnersPolicyEscalation2Minimum Technical Owners
MinimumBusinessOwnersPolicyEscalation3Minimum Business Owners
InactivityPolicyEscalation4Activity
BaselineConfigurationPolicyEscalation5Baseline Configuration
info

eventType and escalationType always describe the same escalation, and both are always sent. Prefer eventType: it is readable, and it matches how the other EasyLife 365 products name their escalations.

The policy object​

policy is the policy state recorded on the application at the moment the escalation was raised. It is the same record EasyLife 365 Identity uses internally, so its property names are abbreviated and it carries state for every rule the policy evaluates, not only the one that escalated.

The names follow a pattern. A two-letter rule prefix is followed by what the value holds:

PrefixRule
owMinimum Application Owners
toMinimum Technical Owners
boMinimum Business Owners
inActivity
bcBaseline Configuration
SuffixHolds
StThe step the rule has reached: reminder0 through reminderN while the owners are still being reminded, then escalate.
StaThe compliance state of the rule: compliant or incompliant.
StChWhen that step last changed, in UTC.

pId is the identifier of the policy governing the application.

warning

Treat everything inside policy as informational. It is an internal record, the set of properties present depends on which rules the policy configures, and property names may change. Route on eventType and identify the application with appObjectId.

Response​

Answer with a 2xx status within 30 seconds. No response body is expected.

Anything else is treated as a failed delivery and retried, as described in Delivery and retries.