Update Group Census Input

Input representation of the details to update a group census from policy enrollments and endorsements on an existing group benefits contract.

JSON Example

{
  "groupCensusId": "0rfxx0000004C92AAA",
  "startDate": "2026-01-01",
  "endDate": "2026-03-31",
  "policyEffectiveDate": "2026-01-01",
  "shouldGenerateCSV": true,
  "shouldIncludeMemberPlans": true,
  "groupCensusAdditionalFields": [
    {
      "key": "Status__c",
      "value": "Active"
    }
  ],
  "filter": {
    "contractGroupPlanIds": [
      "0gpxx0000000001AAA"
    ],
    "objectName": "Contact",
    "recordIds": [
      "003xx000004WhKhAAK"
    ]
  }
}

Properties

Name	Type	Description	Required or Optional	Available Version
`endDate`	String	End date of the time period that's used to find policy enrollments and endorsements that update the group census and associated records. Specify the date in `YYYY-MM-DD` format.	Required	68.0
`filter`	Insurance Census Filter Input	Filter criteria that identify which policy records associated with the insurance contract to include when updating the group census. You can filter by root contract group plan IDs, Person Accounts, and Contacts.	Optional	68.0
`groupCensusAdditionalFields`	Apex String[]	Key-value pairs of additional group census member field values to update. Each entry contains a field API name and value.	Optional	68.0
`groupCensusId`	String	ID of the group census record to update.	Required	68.0
`policyEffectiveDate`	String	Date that's used to determine the policy version for updating member and plan configuration details, in YYYY-MM-DD format. The specified date must fall between the policy version's `effectiveFromDate` and `effectiveToDate`.	Required	68.0
`requestId`	String	ID of the asynchronous request from a previous run. Use with `groupCensusId` to retry updating the records that failed in a previous run.	Required to rerun the asynchronous job to update a group census that failed in a previous run	68.0
`shouldGenerateCSV`	Boolean	Indicates whether to create a CSV file with the updated group census details (`true`) or not (`false`). The default value is `false`.	Optional	68.0
`shouldIncludeMemberPlans`	Boolean	Indicates whether to include plan details for the members when updating the group census (`true`) or not (`false`). The default value is `false`.	Optional	68.0
`startDate`	String	Start date of the time period that's used to find policy enrollments and endorsements that update the group census and associated records. Specify the date in `YYYY-MM-DD` format.	Required	68.0