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

# Add Whitelist Address

> Add an address to a whitelist.

**[MCP scope](https://apidocs.finrock.io/api-reference/mcp-scopes.md):** `dac.write`

Use this endpoint to add an address to a [whitelist](https://apidocs.finrock.io/guides/whitelist-addresses.md). A new address starts as `UnApproved` and can be used once the owner approves it in the Finrock dashboard. Check its status with [List Whitelist Addresses](https://apidocs.finrock.io/api-reference/whitelists/list-whitelist-addresses.md).

## Body Parameters

**guid** `string` *required*

The ID of the whitelist, from [List Whitelists](https://apidocs.finrock.io/api-reference/whitelists/list-whitelists.md). The whitelist must be active.

**address** `string` *required*

The wallet address. At least 10 characters. It can't be a Finrock wallet address.

**asset** `string`

The asset the address is for, for example `BTC`. Upper-case. If you send it, Finrock checks the address against that asset's network. If you leave it out, the address applies to all assets.

**label** `string`

A label for the address.

**tag** `string`

The destination tag or memo, for assets that use one.

```bash cURL theme={null}
curl --request POST \
     --url https://api.finrock.io/dac/v1/whitelist-address \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR_API_KEY' \
     --data '{
       "guid": "8fb22996-2cd1-4a2a-9773-ebfde21c6982",
       "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
       "label": "ETH Address 1",
       "asset": "ETH"
     }'
```

## Response

**code** `integer`

`1000` when the address was added.

**error** `string | null`

`null` on success.

**info** `string | null`

Additional information, if any. `null` on success.

```json 200 theme={null}
{
  "code": 1000,
  "error": null,
  "info": null
}
```

## Errors

Finrock refuses the address in these cases:

* The whitelist isn't active (switched off with [Edit Whitelist](https://apidocs.finrock.io/api-reference/whitelists/edit-whitelist.md)). The error is `400` `INVALID_ACTION`.
* The address is already on the whitelist. An address added without an asset also blocks adding the same address for a specific asset.
* The address belongs to a Finrock wallet.
* The address is invalid for the asset's network.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.