---
schema_version: "1"
id: cb3eb763cd8f12e79318bd5de4f1972be752e4894980678db9ecd63afa3ad7aa
title: Update Group Census Action
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/actions_obj_refresh_census.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/actions_obj_refresh_census.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: bc022e7d95995f688f44cf2e91bb60406ded18576564e7ce7a87906ca742deef
description: Asynchronously update a group census using the insurance contract data. Specify the date range, and the API updates the group census member and plan configuration details based on the policy enrollments or adjustments during the specified time period.
---
# Update Group Census Action

Asynchronously update a group census using the insurance contract data. Specify the date range, and the API updates the group census member and plan configuration details based on the policy enrollments or adjustments during the specified time period.

This action is available in API version 68.0 and later.

## Supported REST HTTP Methods

**URI**: /services/data/vXX.X/actions/standard/refreshCensus

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

| Input | Type | Description |
| --- | --- | --- |
| contractId | string | Required. ID of the insurance contract whose details to use to update the group census. |
| insRefreshCensusInputRep | Apex-defined | Required. An Apex ConnectApi.InsuranceRefreshCensusInputRepresentation record that contains the configuration details for updating a group census. |

## Outputs

| Output | Type | Description |
| --- | --- | --- |
| insRefreshCensusRep | Apex-defined | An Apex ConnectApi.InsuranceRefreshCensusRepresentation record that contains the asynchronous request ID and the ID of the group census record that’s updated. |

## Example

**POST**

This sample request is for the Update Group Census action.

{
  "inputs": \[
    {
      "contractId": "800xx0000004C92AAE",
      "insRefreshCensusInputRep": {
        "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"
          \]
        }
      }
    }
  \]
}

This sample response is for the Update Group Census action.

\[
  {
    "actionName": "refreshCensus",
    "errors": null,
    "invocationId": null,
    "isSuccess": true,
    "outcome": null,
    "outputValues": {
      "insRefreshCensusRep": {
        "message": "Census generation started successfully",
        "groupCensusId": "0rfxx0000004C92AAA",
        "requestId": "08Pxx0000000001EAA"
      }
    },
    "sortOrder": -1,
    "version": 1
  }
\]