Contacts on an unverified policy

The only time you can add contacts to an unverified policy is in the composite request after the unverified policy has been created and before the claim is created. If you need to add contacts after the claim has been created, you must add them to the claim directly.

This requirement exists because all contacts in the ClaimCenter database must be ClaimContacts associated with a claim. When an unverified policy is created, any contacts associated with it are in a temporary state. When the associated claim is created, the contacts are copied over to the claim and become ClaimContacts. This occurs before the claim is committed to the database. If the system APIs gave you the ability to add contacts to the unverified policy after this point, those contacts would be associated only with the policy and would not be ClaimContacts, and ClaimCenter does not allow this.

To create a policy contact, use the following endpoint:

  • POST /claim/v1/unverified-policies/policyId/contacts

When creating a policy contact, you must specify a contactSubtype. This is a typecode from the Contact typelist. Based on the chosen value, there may be additional required fields. For example, a contact whose contactSubtype is Person also requires a last name.

The following example creates an unverified policy with a policy contact (and a claim for the unverified policy). Note that the contact is created after the unverified policy and before the claim.

POST /composite/v1/composite

{
  "requests": [
    {
      "method": "post",
      "uri": "/claim/v1/unverified-policies",
      "body": {
        "data": {
          "attributes": {
            "policyNumber": "unverified-with-contact",
            "policyType": {
              "code": "PersonalAuto"
            }
          }
        }
      },
      "vars": [
        {
          "name": "policyId",
          "path": "$.data.attributes.id"
        }
      ]
    },
        {
      "method": "post",
      "uri": "/claim/v1/unverified-policies/${policyId}/contacts",   
      "body": {       
        "data": {
          "attributes": {
            "contactSubtype": "Person",
            "firstName": "Ray",
            "lastName": "Newton"
          }
        }
      }
    },
    {
      "method": "post",
      "uri": "/claim/v1/claims",
      "body": {
        "data": {
          "attributes": {
            "lossDate": "2021-03-04T07:00:00.000Z",
            "policyNumber": "unverified-with-contact"
            }            
          }
        }
    }
  ]
}