PRE_POLICY_CANCELLATION

This event is fired when a pre-cancellation notice is issued for a policy. It notifies that the policy will be cancelled on a future date.

When and what fires this event?

If this event is defined on a product, and it has actions that are enabled:

Copilot: fires when a pre-cancellation notice is issued;
API: can fire this event externally on demand.

Request payload

POST: https://api.{ENV}.dais.com/ioi/v3/event/fire

curl --location --request POST 'https://api.{ENV}.dais.com/ioi/v3/event/fire' \
--header 'Authorization: Basic <yourAuthHere>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "lineId": "<UUID of the product>",
    "type": "PRE_POLICY_CANCELLATION",
    "payload": {
        "configId": "<configId>",
        "effectiveDate": "<effectiveDate>",
        "label": "<label>",
        "backofficeIntake": {
            "<qid>": {
                "type": "ANSWER",
                "answer": "<answer>"
            }
        }
    }
}'

{
  "lineId": "262e67be-c08c-43c0-bb51-06fe4408b4e9",
  "type": "PRE_POLICY_CANCELLATION",
  "payload": {
    "policyId": "21e398b3-1713-44b7-b044-7328f34efaa4",
    "configId": "262c67be-c08c-43c0-bb51-06fe4408b4e9",
    "effectiveDate": "2020-01-13",
    "label": "label",
    "backofficeIntake": {
      "numEmployees": {
        "type": "ANSWER",
        "answer": "17"
      }
    }
  }
}

Request fields

Type	Required	Description
`lineId`	`true`	UUID for the associated product
`type`	`true`	Must be set to `PRE_POLICY_CANCELLATION`
`payload`	`true`	Explained below

Payload fields

Property	Required	Description
`policyId`	`false`	UUID for the policy
`configId`	`true`	Cancellation config ID
`effectiveDate`	`true`	Effective date
`label`	`true`	Label
`backOfficeIntake`	`true`	Map of qid to answer

Response json

{
  "triggerRequestId": "386861af-6875-49b2-b38c-c435263039be",
  "executedActionCount": 0,
  "expectedResponseCount": 0,
  "metadata": {}
}

Response fields

Property	Required	Description
`triggerRequestId`	`true`	UUID that uniquely identifies the trigger execution instance.
`executedActionCount`	`true`	Number of actions executed during this trigger run.
`expectedResponseCount`	`true`	Number of responses expected from the executed actions.
`metadata`	`true`	Contains dynamically generated data from executed workflow actions.