Creating contingencies

Use the following endpoints to create a contingency associated with either a job or a policy:

  • POST /jobs​/{jobId}​/contingencies
  • POST ​/policies​/{policyId}​/contingencies

Minimum creation criteria

At a minimum, a contingency must specify:

  • A title
  • A description
  • A dueDate
  • An action, which must be set to a typecode from the ContingencyAction typelist

For example, the following request creates a new contingency for policy pc:62 with the given title and description. The due date is November 11, 2021. If the contingency is not resolved by then, PolicyCenter will take the action of retroactively changing the policy (to remove the good driver discount).

POST /policy/v1/policies/pc:62/contingencies

{
  "data": {
    "attributes": {
      "action": {
        "code": "ChangeRetroactively"
      },
      "description": "Driving record required for good driver discount",
      "dueDate": "2021-11-11T00:00:00.000Z",
      "title": "Driving record required"
    }
  }
}

Creating related objects

Use the following endpoint to create activities, documents, and notes for a contingency.

Contingencies associated with jobs

Endpoint Description
POST ​/jobs​/{jobId}​/contingencies​/{contingencyId}​/activities Create an activity associated with the given contingency on the given job
POST /jobs​/{jobId}​/contingencies​/{contingencyId}​/documents Create a document associated with the given contingency on the given job
POST /jobs​/{jobId}​/contingencies​/{contingencyId}​/notes Create a note associated with the given contingency on the given job

Contingencies associated with policies

Endpoint Description
POST /policies​/{policyId}​/contingencies​/{contingencyId}​/activities Create an activity associated with the given contingency on the given policy
POST /policies​/{policyId}​/contingencies​/{contingencyId}​/documents Create a document associated with the given contingency on the given policy
POST /policies​/{policyId}​/contingencies​/{contingencyId}​/notes Create a note associated with the given contingency on the given policy

When an activity is created directly for an account, job, or policy, you must specify an activity pattern. However, when an activity is created for a contingency, you must omit the activity pattern. All activities created through contingencies use the "New Contingency" activity pattern (uw_review_contingency). If the request payload contains an activity pattern, the request fails.

For more information on working with activities, documents, or notes, see the following: