> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update account holder group

> Use this endpoint to update a specific account holder group.

PUT/accountholdergroups/\{token}

Use this endpoint to update a specific account holder group. Only values of parameters in the request are modified; all others are left unchanged.

To update a specific account holder group, send a `PUT` request to the `/accountholdergroups/{token}` endpoint. Use the `token` path parameter to specify the account holder group to update. Include the account holder group details to update in [JSON](http://json.org) format in the body of the request.

> [!NOTE]
>
> **Note**\
> While you can update account holder groups that you create, the default group is restricted and requires special permissions to update.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | Unique identifier of the account holder group. **Allowable Values:**  Existing account holder group token |

## Request body

| Fields | Description |
| - | - |
| config object  Optional | Contains configuration fields for the account holder group. **Allowable Values:**  `is_reloadable`, `kyc_required`, `pre_kyc_controls`, `real_time_fee_group_token` |
| config.**is\_reloadable** boolean  Optional | If set to `false`, this control prohibits an account holder's account from being reloaded with funds after the initial load. This restriction applies to GPA orders, peer transfers, and direct deposits, but does not apply to operator adjustments. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| config.**kyc\_required** string  Optional | If set to `ALWAYS`, new account holders are created in an `UNVERIFIED` status and must pass identity verification (KYC) before they can be active; if set to `CONDITIONAL`, new account holders begin in a `LIMITED` status and have limited actions available before passing identity verification; if set to `NEVER`, new account holders are created in an active state. **Allowable Values:**  `ALWAYS`, `CONDITIONAL`, `NEVER` **Default value:** `NEVER` |
| config.**pre\_kyc\_controls** object  Optional | Contains configuration fields for a number of controls. **NOTE:** These controls are in effect only if `kyc_required` is `ALWAYS` or `CONDITIONAL` and the account holder has not yet passed KYC. **Allowable Values:**  `balance_max`, `cash_access_enabled`, `enable_non_program_loads`, `international_enabled`, `is_reloadable_pre_kyc` |
| config.pre\_kyc\_controls.**balance\_max** decimal  Optional | Specifies the maximum ledger balance allowed for members of the account holder group. **Allowable Values:**  0.01 min **Default value:** 0 |
| config.pre\_kyc\_controls.**cash\_access\_enabled** boolean  Optional | If set to `false`, this control prohibits an account holder's cards from being used at an ATM. **NOTE:** If a card product's `config.poi.atm` field is set to `false`, associated cards are prohibited from being used at an ATM regardless of this control's setting. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| config.pre\_kyc\_controls.**enable\_non\_program\_loads** boolean  Optional | If set to `true`, funds can only be loaded from a program funding source. This restriction applies to GPA orders, peer transfers, and direct deposits, but does not apply to operator adjustments. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| config.pre\_kyc\_controls.**international\_enabled** boolean  Optional | If set to `false`, this control prohibits an account holder from conducting transactions with a non-domestic country code. **NOTE:** If a card product is configured to prohibit non-domestic transactions, its associated cards are prohibited from such transactions regardless of this control's setting. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| config.pre\_kyc\_controls.**is\_reloadable\_pre\_kyc** boolean  Optional | If set to `false`, this control prohibits an account holder's account from being reloaded with funds after an initial load. This restriction applies to GPA orders, peer transfers, and direct deposits, but does not apply to operator adjustments. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| config.**real\_time\_fee\_group\_token** string  Optional | Associates the specified real-time fee group with the members of the account holder group. **Allowable Values:**  36 char max |
| name string  Optional | Descriptive name for the account holder group. **Allowable Values:**  1–40 chars |

## Sample request body

```json JSON lines wrap theme={null}
{
  "config": {
    "pre_kyc_controls": {
      "balance_max": 500
    }
  }
}
```

## Response body

| Fields | Description |
| - | - |
| config object  Conditionally returned | Contains configuration fields for the account holder group. **Allowable Values:**  `is_reloadable`, `kyc_required`, `pre_kyc_controls`, `real_time_fee_group_token` |
| config.**is\_reloadable** boolean  Conditionally returned | If set to `false`, this control prohibits an account holder's account from being reloaded with funds after the initial load. This restriction applies to GPA orders, peer transfers, and direct deposits, but does not apply to operator adjustments. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| config.**kyc\_required** string  Conditionally returned | If set to `ALWAYS`, new account holders are created in an `UNVERIFIED` status and must pass identity verification (KYC) before they can be active; if set to `CONDITIONAL`, new account holders begin in a `LIMITED` status and have limited actions available before passing identity verification; if set to `NEVER`, new account holders are created in an active state. **Allowable Values:**  `ALWAYS`, `CONDITIONAL`, `NEVER` **Default value:** `NEVER` |
| config.**pre\_kyc\_controls** object  Conditionally returned | Contains configuration fields for a number of controls. **NOTE:** These controls are in effect only if `kyc_required` is `ALWAYS` or `CONDITIONAL` and the account holder has not yet passed KYC. **Allowable Values:**  `balance_max`, `cash_access_enabled`, `enable_non_program_loads`, `international_enabled`, `is_reloadable_pre_kyc` |
| config.pre\_kyc\_controls.**balance\_max** decimal  Conditionally returned | Specifies the maximum ledger balance allowed for members of the account holder group. **Allowable Values:**  0.01 min **Default value:** 0 |
| config.pre\_kyc\_controls.**cash\_access\_enabled** boolean  Conditionally returned | If set to `false`, this control prohibits an account holder's cards from being used at an ATM. **NOTE:** If a card product's `config.poi.atm` field is set to `false`, associated cards are prohibited from being used at an ATM regardless of this control's setting. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| config.pre\_kyc\_controls.**enable\_non\_program\_loads** boolean  Conditionally returned | If set to `true`, funds can only be loaded from a program funding source. This restriction applies to GPA orders, peer transfers, and direct deposits, but does not apply to operator adjustments. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| config.pre\_kyc\_controls.**international\_enabled** boolean  Conditionally returned | If set to `false`, this control prohibits an account holder from conducting transactions with a non-domestic country code. **NOTE:** If a card product is configured to prohibit non-domestic transactions, its associated cards are prohibited from such transactions regardless of this control's setting. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| config.pre\_kyc\_controls.**is\_reloadable\_pre\_kyc** boolean  Conditionally returned | If set to `false`, this control prohibits an account holder's account from being reloaded with funds after an initial load. This restriction applies to GPA orders, peer transfers, and direct deposits, but does not apply to operator adjustments. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| config.**real\_time\_fee\_group\_token** string  Conditionally returned | Associates the specified real-time fee group with the members of the account holder group. **Allowable Values:**  36 char max |
| name string  Conditionally returned | Descriptive name for the account holder group. This field is returned if it exists in the resource. **Allowable Values:**  Existing account holder group name |
| token string  Conditionally returned | Unique identifier of the account holder group. This field is always returned. **Allowable Values:**  Existing account holder group token |


## Related topics

- [Account Holder Groups Overview](https://www.marqeta.com/docs/core-api/account-holder-groups.md)
- [Account Holder Groups Object](https://www.marqeta.com/docs/core-api/account-holder-groups/account-holder-groups-object.md)
- [Create account holder group](https://www.marqeta.com/docs/core-api/account-holder-groups/create-account-holder-group.md)
- [List account holder groups](https://www.marqeta.com/docs/core-api/account-holder-groups/list-account-holder-groups.md)
- [Retrieve account holder group](https://www.marqeta.com/docs/core-api/account-holder-groups/retrieve-account-holder-group.md)