Insurance Contacts and Users (POST)

Create contacts and portal users for group census members. The Contact record is used for linking to the appropriate policy for policy association, and the corresponding portal user is created to allow the member to log in to the community portal.

Special Access Rule

To use this API, the org must be enabled with Person Account and you must have Census Management user access.

Resource

1/connect/insurance/contacts

Resource example

1https://yourInstance.salesforce.com/services/data/v67.0/connect/insurance/contacts?createPortalUsers=false

Available version

65.0

HTTP methods

POST

Request parameters for POST

Parameter Name	Type	Description	Required or Optional	Available Version
`createPortalUsers`	Boolean	Indicates whether to create portal users for the new contacts (`true`) or not (`false`). The default value is `true`.	Optional	65.0

Request body for POST

JSON example

This is a sample JSON example with GroupCensusId.

1{
2  "groupCensusId": "0rfxx0000000007AAA",
3  "matchingKeyList": {
4    "values": [
5      "FirstName",
6      "LastName"
7    ]
8  },
9  "fieldMappings": {
10    "data": {
11      "FirstName": "FirstName",
12      "Lastname": "LastName"
13    }
14  },
15  "userDetails": {
16    "profileId": "00exx000000mzxC",
17    "localeSidKey": "en_US",
18    "timeZoneSidKey": "America/New York",
19    "languageLocaleKey": "en_US",
20    "emailEncodingKey": "UTF-8"
21  }
22}

This is a sample JSON example with GroupCensusMembers.

1{
2  "groupCensusMemberIdList": {
3    "values": [
4      "0r6xx0000000002AAA",
5      "0r6xx000000004rAAA"
6    ]
7  },
8  "matchingKeyList": {
9    "values": [
10      "FirstName",
11      "LastName"
12    ]
13  },
14  "fieldMappings": {
15    "data": {
16      "FirstName": "FirstName",
17      "Lastname": "LastName"
18    }
19  },
20  "userDetails": {
21    "profileId": "00exx000000mzxC",
22    "localeSidKey": "en_US",
23    "timeZoneSidKey": "America/New York",
24    "languageLocaleKey": "en_US",
25    "emailEncodingKey": "UTF-8"
26  }
27}

Properties

Name	Type	Description	Required or Optional	Available Version
`fieldMappings`	Map	Map of field API names from the Group Census Member object (key) to the Contact object (value).	Optional	65.0
`groupCensusId`	String	ID of the group census.	Optional	65.0
`groupCensusMemberIdList`	String[]	IDs of the group census members for whom you want to create contacts and users. If not provided, all members of the specified group census are processed.	Optional	65.0
`matchingKeyList`	String[]	List of field API names on the Group Census Member object that are used to identify and prevent the creation of duplicate contact records. The default fields are FirstName, LastName, Birthdate, Email, and Gender.	Optional	65.0
`userDetails`	Portal User Creation Input	Details to create portal users. This property is required if the `createPortalUsers` parameter in the method call is set to `true`.	Optional	65.0

Response body for POST

Insurance Contacts and Users Creation Response

Insurance Developer Guide

Insurance Contacts and Users (POST)