---
schema_version: "1"
id: 854e14cd342219d37a784add9ca6a15a0b4212b0678e5f6c90e24fe452838dc1
title: Update Group Census (PATCH)
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/connect_resources_refresh_census.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_refresh_census.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 878eb0a76b638750caf63f233e18289470b849237cd15333c6adfafa3c56d479
description: Update a group census from policy enrollments and endorsements on an existing group benefits contract for a specified date range. This API runs asynchronously and returns a request ID that you can use to track the job or retry a failed run.
---
# Update Group Census (PATCH)

Update a group census from policy enrollments and endorsements on an existing group benefits contract for a specified date range. This API runs asynchronously and returns a request ID that you can use to track the job or retry a failed run.

## Resource

{contractId} is a placeholder.

/connect/insurance/contracts/{contractId}/actions/refresh-census

## Resource Example

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

https://{yourInstance}.salesforce.com/services/data/v68.0/connect/insurance/contracts/800xx0000004C92AAE/actions/refresh-census

## Available Version

68.0

## HTTP Methods

PATCH

## Path Parameter for PATCH

| Parameter Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| contractId | String | ID of the insurance contract whose policy enrollments and endorsements are used to update the group census. | Required | 68.0 |

## Request Body for PATCH

### 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 |

## Response Body for PATCH

[Update Group Census Response](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_responses_insurance_refresh_census.htm "Output representation of the details that are returned when you update a group census from policy enrollments and endorsements on an existing group benefits contract.")