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.

Resource 

1/connect/insurance/contacts

Resource Example 

Replace {yourInstance} with the My Domain name of your Salesforce org.

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

Available Version 

65.0

HTTP Methods 

POST

Request Parameters for POST 

Parameter NameTypeDescriptionRequired or OptionalAvailable Version
createPortalUsersBooleanIndicates whether to create portal users for the new contacts (true) or not (false).
The default value is true.
Optional65.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 

NameTypeDescriptionRequired or OptionalAvailable Version
fieldMappingsMapMap of field API names from the Group Census Member object (key) to the Contact object (value).Optional65.0
groupCensusIdStringID of the group census.Optional65.0
groupCensusMember​IdListString[]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.
Optional65.0
matchingKeyListString[]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.
Optional65.0
userDetailsPortal User Creation InputDetails to create portal users.
This property is required if the createPortalUsers parameter in the method call is set to true.
Optional65.0

Response Body for POST 

Insurance Contacts and Users Creation Response