Create Contacts and Users from Group Census Members Action

Create contacts and portal users for group census or group census members.

This action supports bulk processing, custom field mapping, and duplicate record detection. It converts insurance group census members to Salesforce Contacs, enables member self-service through portal users, supports B2C enrollment workflows, and maintains relationship data for benefits administration and household grouping.

This action is available in API version 65.0 and later.

Special Access Rules

The org must have Digital Insurance Group Benefits enabled. To use this action, you need Census Management user access.

Supported REST HTTP Methods

URI: /services/data/vXX.X/actions/standard/createCtctUsrFrGrpCens

Where XX.X is the latest API version.

Formats: JSON

HTTP Methods: POST

Authentication: Authorization: Bearer TOKEN

Where TOKEN is your OAuth access token.

Inputs

Input	Type	Description
`contactFieldsMapping`	Apex-defined	Map of Group Census Member Object fields to Contact fields.
`createPortalUsers`	boolean	Indicates whether the portal users must be created ( `true` ) or not ( `false` ).
`emailEncodingKey`	string	Required if `createPortalUsers` is set to `true` . Email encoding key to use to create the user records. For example, ISO-8859-1 or UTF-8.
`groupCensusId`	string	Required if `groupCensusMembers` isn’t specified. ID of the group census to create contacts and portal users for the associated group census members.
`groupCensusMembers`	sobject	Required if `groupCensusId` isn’t specified. Group census member records to create contacts and portal users for.
`localeSidKey`	string	Required if `createPortalUsers` is set to `true` . Locale for the user, which affects the format of dates, times, and numbers.
`languageLocaleKey`	string	Required if `createPortalUsers` is set to `true` . Language to use to create the user records. For example, `fr` for French or `zh_Cw` for Chinese (Traditional).
`matchingKeysList`	string	Comma-separated list of contact object fields to detect duplicate contact records.
`profileId`	string	Required if `createPortalUsers` is set to `true` . ID of the profile to create the user records for.
`timeZoneSidKey`	string	Required if `createPortalUsers` is set to `true` . Time zone for the user, such as America or Los_Angeles.

Outputs

Output	Type	Description
`createContactsOutputRep`	Apex-defined	An apex `ind_ins_grpben__ContactsAndUsersCreationOutput` record that contains the details of the results.

Example

Sample Request

1{
2  "inputs": [
3    {
4      "groupCensusMembers": [
5        {
6          "Id": "0r6xx00000001tuAAA"
7        },
8        {
9          "Id": "0r6xx00000001tvAAA"
10        }
11      ],
12      "matchingKeysList": [
13        "Email",
14        "LastName"
15      ],
16      "contactFieldsMapping": [
17        {
18          "key": "FirstName__c",
19          "value": "FirstName"
20        },
21        {
22          "key": "Email__c",
23          "value": "Email"
24        }
25      ],
26      "createPortalUsers": true,
27      "profileId": "00exx000000n0ywAAA",
28      "timeZoneSidKey": "America/New_York",
29      "localeSidKey": "en_US",
30      "emailEncodingKey": "UTF-8",
31      "languageLocaleKey": "en_US"
32    }
33  ]
34}

Sample Response

1{
2  "outputs": [
3    {
4      "createContactsOutputRep": {
5        "memberContactDetails": [
6          {
7            "groupCensusMemberId": "0r6xx00000001tuAAA",
8            "contactId": "003xx000004WhsgAAC",
9            "userId": "005xx000001X8vwAAC"
10          }
11        ],
12        "errors": [
13          {
14            "code": "SF-0004-0058",
15            "message": "Contact already exists for member",
16            "additionalInfo": [
17              {
18                "key": "memberId",
19                "value": "0r6xx00000001tvAAA"
20              }
21            ]
22          }
23        ]
24      },
25      "isSuccess": true
26    }
27  ]
28}