Save Group Census Member Plans Data Action

Validate and save group census member plans for the new members. Update the group census member plans for existing members.

This action processes member enrollment information, validates plan assignments, and handles primary and dependent member relationships. It manages plan updates, including plan additions and deletions, and supports bulk processing of member plans with comprehensive error handling and logging.

This action is available in API version 66.0 and later.

Special Access Rules 

To use this invocable action, you must have Digital Insurance Group Benefits Census Management user access

Supported REST HTTP Methods 

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

Where XX.X is the latest API version.

Formats: JSON, XML

HTTP Methods: POST

Authentication: Authorization: Bearer TOKEN

Where TOKEN is your OAuth access token.

Inputs 

InputTypeDescription
asyncBulkRequestItemIdstringRequired. ID of the asynchronous bulk request item to use for tracking and error logging.
groupCensusIdstringRequired. ID of the group census record.
groupCensusMemberPlanssobjectRequired. List of group census member plan records to save.
groupCensusMemberssobjectRequired. List of group census member records to process.
shouldLogErrorsbooleanRequired. Indicates whether errors that occur while saving group census member plans are recorded in a content document ( true ) or not ( false ).

Outputs 

OutputTypeDescription
errorsDataApex-definedError details for the failed records.
groupCensusMemberPlanssobjectDetails of group census member plan records that are successfully saved.

Example 

POST

This sample request is for the Save Group Census Member Plans Data action.

1{
2  "inputs": [
3    {
4      "groupCensusMembers": [
5        {
6          "Id": "a1B000000000001",
7          "MemberRefId": "M001",
8          "PrimaryGroupCensusMemberId": null,
9          "GroupCensusId": "a3B000000000001",
10          "MemberKey": "EMP001",
11          "AssociationWithPrimaryMbr": "Self"
12        },
13        {
14          "Id": "a1B000000000002",
15          "MemberRefId": "M002",
16          "PrimaryGroupCensusMemberId": "a1B000000000001",
17          "GroupCensusId": "a3B000000000001",
18          "MemberKey": "DEP001",
19          "AssociationWithPrimaryMbr": "Spouse"
20        }
21      ],
22      "groupCensusMembersPlans": [
23        {
24          "ContractGroupPlanId": "p1B000000000001",
25          "PlanName": "Health Plan A",
26          "PlanType": "Medical",
27          "GroupCensusMember": "a1B000000000001",
28          "MemberRefId": "M001"
29        },
30        {
31          "ContractGroupPlanId": "p1B000000000002",
32          "PlanName": "Dental Plan B",
33          "PlanType": "Dental",
34          "GroupCensusMember": "a1B000000000001",
35          "MemberRefId": "M001"
36        },
37        {
38          "ContractGroupPlanId": "p1B000000000001",
39          "PlanName": "Health Plan A",
40          "PlanType": "Medical",
41          "GroupCensusMember": "a1B000000000002",
42          "MemberRefId": "M002"
43        }
44      ],
45      "shouldLogErrors": true,
46      "asyncBulkRequestItemId": "a2B000000000001",
47      "groupCensusId": "a3B000000000001"
48    }
49  ]
50}

This sample response is for the Save Group Census Member Plans Data action.

1{
2  "outputs": [
3    {
4      "savedGroupCensusMembersPlans": [
5        {
6          "Id": "a4B000000000001",
7          "Name": "Plan-001",
8          "GroupCensusMemberId": "a1B000000000001",
9          "ContractGroupPlanId": "p1B000000000001",
10          "CreatedDate": "2025-01-27T10:30:00.000Z",
11          "CreatedById": "005000000000001"
12        },
13        {
14          "Id": "a4B000000000002",
15          "Name": "Plan-002",
16          "GroupCensusMemberId": "a1B000000000001",
17          "ContractGroupPlanId": "p1B000000000002",
18          "CreatedDate": "2025-01-27T10:30:00.000Z",
19          "CreatedById": "005000000000001"
20        },
21        {
22          "Id": "a4B000000000003",
23          "Name": "Plan-003",
24          "GroupCensusMemberId": "a1B000000000002",
25          "ContractGroupPlanId": "p1B000000000001",
26          "CreatedDate": "2025-01-27T10:30:00.000Z",
27          "CreatedById": "005000000000001"
28        }
29      ],
30      "errors": [
31        {
32          "errorMessage": "Invalid plan assignment for member M003",
33          "recordId": "M003",
34          "errorType": "VALIDATION_ERROR",
35          "fieldName": "ContractGroupPlanId"
36        }
37      ],
38      "isSuccess": true
39    }
40  ]
41}