Overview of policy contacts

In PolicyCenter, every job has an underlying policy. You can associate account contacts with this policy. For example, when a submission is created for an account, the default behavior is to associate the account's "primary insured" contact with the underlying policy as the "primary named insured". A contact associated with a policy is known as a policy contact. Policy contacts exist on policies that are unbound (such as a submission's underlying policy) and on policies that are bound.

In the PolicyCenter data model, there is no PolicyContact entity. Policy contacts are stored in the database using multiple entities:

  • The Contact entity
  • The AccountContact entity
  • One or more PolicyContactRole entities

In Cloud API, policy contacts are managed using a resource named PolicyContact. This resource gathers the information from multiple data model entities (Contact, AccountContact, and PolicyContactRole).

The following table summarizes the different base configuration /contact endpoints in each API and the resources used by those endpoints.

API Example endpoints Root resource type
Account

GET /account/v1/accounts/{accountId}/contacts

POST /account/v1/accounts/{accountId}/contacts

GET /account/v1/accounts/{accountId}/contacts/{contactId}

PATCH /account/v1/accounts/{accountId}/contacts/{contactId}

DELETE /account/v1/accounts/{accountId}/contacts/{contactId}

AccountContact
Job

GET /job/v1/jobs/{jobId}/contacts

POST /job/v1/jobs/{jobId}/contacts

GET /job/v1/jobs/{jobId}/contacts/{contactId}

PATCH /job/v1/jobs/{jobId}/contacts/{contactId}

DELETE /job/v1/jobs/{jobId}/contacts/{contactId}

PolicyContact
Policy

GET /policy/v1/policies/{policyId}/contacts

GET /policy/v1/policies/{policyId}/contacts/{contactId}

PolicyContact

Policy contact roles

Some policy contact roles are LOB-agnostic. You can use these roles for contacts on any policy, regardless of the underlying LOB. In Cloud API, you can specify the following LOB-agnostic roles for a policy contact.

Role's display name Underlying policy role entity
Primary named insured PolicyPriNamedInsured
Additional named insured PolicyAddlNamedInsured

(used for any contact associated with a policy, but not displayed in the user interface)

APDPolicyInvolvedParty

Some policy contact roles are LOB-specific. For example, in the base configuration Personal Auto product, adding a contact to a job's underlying policy using the POST /vehicle-drivers endpoint adds the "driver" role to the contact. The behavior of LOB-specific roles is dependent on how the product is modeled.

The remainder of this topic discusses how to manage policy contacts and the LOB-agnostic policy contact roles.