---
schema_version: "1"
id: 2be84a870ade9777b20ef169655626ed81b7ca379d0070a023b625f0f0751635
title: Update Group Census Input
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/connect_requests_insurance_refresh_census_input.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_requests_insurance_refresh_census_input.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 459edc93f5e909c8b7646460dd2fd431497c3d7d56ad36c2b400997fa59edcc9
description: Input representation of the details to update a group census from policy enrollments and endorsements on an existing group benefits contract.
---
# 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](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_requests_insurance_census_filter_input.htm "Input representation of the filter criteria that select which policy records to include when generating a group census from a contract.") | 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](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_requests_insurance_apex_string.htm "Input representation for a key-value pair.")\[\] | 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 |