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

# Manage fee-wrapper access

> Authorize customer addresses to deposit into an organization fee wrapper.

Each fee wrapper has a customer allowlist separate from the gtoken's backing
vault allowlist. Ground authorizes the wrapper contract against that vault;
your backend authorizes customer addresses against the wrapper.

Use the wrapper `id` returned by the fee-wrapper API and the customer address
that will receive shares:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
export FEE_WRAPPER_ID="8f4c52d7-62ab-4db9-a964-92f481f6b851"
export CUSTOMER_ADDRESS="0x3bf25a73a1f1033c2d50ac65f3c9d6a44123db81"
```

## Add an address

Wait for the wrapper to reach `status: ready`, then call:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X PUT \
  "https://sandbox.groundtech.co/v2/fee-wrappers/$FEE_WRAPPER_ID/allowlist/$CUSTOMER_ADDRESS" \
  -H "Authorization: Bearer $GROUND_API_KEY"
```

The path parameter is an address, which may be an EOA, smart account, multisig,
or contract.

## Verify access

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl \
  "https://sandbox.groundtech.co/v2/fee-wrappers/$FEE_WRAPPER_ID/allowlist/$CUSTOMER_ADDRESS" \
  -H "Authorization: Bearer $GROUND_API_KEY"
```

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "allowed": true
}
```

Only enable a deposit after the effective state is true. If the mutation returns
`202`, its transaction hash is only submission evidence; poll this endpoint or
consume the corresponding webhook event for confirmation.

## Remove access

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X DELETE \
  "https://sandbox.groundtech.co/v2/fee-wrappers/$FEE_WRAPPER_ID/allowlist/$CUSTOMER_ADDRESS" \
  -H "Authorization: Bearer $GROUND_API_KEY"
```

Removal blocks new deposits after confirmation. It preserves the address's
ability to redeem an existing fee-wrapper position.

API reference:
[add](/api-reference/add-fee-wrapper-allowlist),
[get](/api-reference/get-fee-wrapper-allowlist), and
[remove](/api-reference/delete-fee-wrapper-allowlist).