> This page is for Taurus PROTECT, version v3.38.
> For other versions, use one of these documentation indexes:
> - v3.58 (default): https://taurushq.ferndocs.com/protect-capital/v3.58/llms.txt
> - v3.56: https://taurushq.ferndocs.com/protect-capital/v3.56/llms.txt
> - v3.54: https://taurushq.ferndocs.com/protect-capital/v3.54/llms.txt
> - v3.52: https://taurushq.ferndocs.com/protect-capital/v3.52/llms.txt
> - v3.50: https://taurushq.ferndocs.com/protect-capital/v3.50/llms.txt
> - v3.48: https://taurushq.ferndocs.com/protect-capital/v3.48/llms.txt
> - v3.46: https://taurushq.ferndocs.com/protect-capital/v3.46/llms.txt
> - v3.44: https://taurushq.ferndocs.com/protect-capital/v3.44/llms.txt
> - v3.42: https://taurushq.ferndocs.com/protect-capital/v3.42/llms.txt
> - v3.40: https://taurushq.ferndocs.com/protect-capital/v3.40/llms.txt
> - v3.38: https://taurushq.ferndocs.com/protect-capital/v3.38/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://taurushq.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://taurushq.ferndocs.com/_mcp/server.

# Create An Address

## Description

This endpoint is used to create an  `Address` in Taurus-PROTECT. To understand what an  `Address` is and how to use it, please refer to the following [page](/protect-capital/v3.38/reference/entities) in the Taurus User Guides.

This is a `POST` method with a JSON payload containing the address details.

For example:

**`JSON`**

```json JSON
{
  "walletId": "66313",
  "label": "Address XYZ",
  "customerId": "customerXYZ",
  "comment": "Deposit ABC",
  "currency": "ETH"
}
```

### Required Parameters

* **walletId**: The ID of the new Wallet where the address will belong.
* **label**: The label assigned to the newly-created address. Presented as `Address Name` in the GUI.

> **Warning**
>
> **Dependency**
>
> Important: You cannot create an address without first creating a wallet. The Wallet ID must be an ID of an existing wallet. If the `walletid`parameter does not match an existing wallet ID, this endpoint will fail.

For a complete list of parameters along, their types, and endpoint response codes please see the API Reference:

[https://docs.taurushq.com/protect-capital/reference/walletservice\_createaddress](/protect-capital/v3.38/reference/addresses/create)

## Prerequisites

### Required Roles

* AccountCreator
* TPUser

To find out more about roles, please refer to the following [page](/user-guides/docs/users-1#creating-a-new-user) in the Taurus User Guides.

## Call Example

You can find a basic example in cURL below.\
Please note that you will need to update the `BASEURL` and the `APITOKEN` for the command to function.

**`cURL`**

```curl cURL
export BASEURL=https://taurus-protect-instance.com
export APIToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MSwiZXh0ZXJuYWxVc2VySUQiOiJ0ZWFtMUV4dGVybmFsVXNlcklEIiwidGVuYW50SUQiOjEsImNhcGl0YWxUZW5hbnRJRCI6MSwiZmlyc3RuYW1lIjoiSm9obiIsImxhc3RuYW1lIjoiRG9lIiwicm9sZXMiOlsidHB1c2VyIl0sImVtYWlsIjoidGVhbTFAYmFuay5jb20iLCJ1c2VybmFtZSI6InRlYW0xIiwiand0X3JlbmV3YWJsZV9hbW91bnQiOjAsImlzX3RvdHBfZW5hYmxlZCI6ZmFsc2UsImF1dGhfc3RhdHVzIjoiU1VDQ0VTUyIsImxhc3RfbG9naW4iOiIyMDIzLTAxLTAxVDAwOjAwOjAwLjE0OTc0NDIzMloiLCJsb2dnZWRfaW5fd2l0aF9zc28iOmZhbHNlLCJrZXkiOiIiLCJleHAiOjE2ODEyMTkyNzYsImlhdCI6MTY4MTIxNzQ3Nn0.K_85arIrigpkN1yHttCydpeT6oVg2c6PyQnuji907Og
curl --location "$BASEURL/api/rest/v1/addresses" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header "Authorization: Bearer $APIToken" \
--data '{
  "walletId": "71336",
  "label": "API-Documentation - Test 4"
  }'
```

This piece of code sends a POST request to [https://your-protect-instance.example.com/api/rest/v1/addresses](https://your-protect-instance.example.com/api/rest/v1/addresses) with the JSON string in the request body.

> **Tip**
>
> **Call Result**
>
> A successful response for the POST call to create an address might look like this:

```json
{
    "result": {
        "id": "726409",
        "walletId": "71336",
        "currency": "ETH",
        "addressPath": "m/44'/60'/96'/0'/0'",
        "address": "0x084ef2b516aac80a6ce5e07999872e88396feba5",
        "label": "Address XYZ",
        "balance": {
            "totalConfirmed": "0",
            "totalUnconfirmed": "0",
            "availableConfirmed": "0",
            "availableUnconfirmed": "0",
            "reservedConfirmed": "0",
            "reservedUnconfirmed": "0"
        },
        "signature": "9pI1j87s7XTkmXN/ST6sZ/Q6Vx1gN3OeHa+6HnaJE9KRmqHzvp8hrOIqKtT6HJJW5UUCITtGKxife5w219D/pA==",
        "creationDate": "2023-03-30T15:42:24.167090Z",
        "updateDate": "2023-03-30T15:42:24.167090Z",
        "walletInfo": {
            "id": "71336",
            "balance": {
                "totalConfirmed": "0",
                "totalUnconfirmed": "0",
                "availableConfirmed": "0",
                "availableUnconfirmed": "0",
                "reservedConfirmed": "0",
                "reservedUnconfirmed": "0"
            },
            "currency": "ETH",
            "coin": "ETH",
            "name": "API-Documentation-Test",
            "accountPath": "m/44'/60'/96'",
            "creationDate": "2023-03-30T15:31:55.170253Z",
            "updateDate": "2023-03-30T15:31:55.170253Z",
            "blockchain": "ETH",
            "currencyInfo": {
                "name": "Ethereum",
                "symbol": "ETH",
                "coinTypeIndex": "60",
                "blockchain": "ETH",
                "decimals": "18",
                "isAccountBased": true,
                "enabled": true,
                "id": "33a7de6af505855d3062715ac4609736a60cf2779f03cd033e74590708c4f0d4",
                "displayName": "Ethereum - ETH",
                "type": "native",
                "network": "mainnet"
            },
            "network": "mainnet"
        },
        "currencyInfo": {
            "name": "Ethereum",
            "symbol": "ETH",
            "coinTypeIndex": "60",
            "blockchain": "ETH",
            "decimals": "18",
            "isAccountBased": true,
            "enabled": true,
            "id": "33a7de6af505855d3062715ac4609736a60cf2779f03cd033e74590708c4f0d4",
            "displayName": "Ethereum - ETH",
            "type": "native",
            "network": "mainnet"
        },
        "canUseAllFunds": true
    }
}
```

In this example, Taurus-PROTECT has created a new *Address* under the specified wallet, and has assigned it a unique ID of "726409". Taurus-PROTECT responds with a JSON object containing the address details, including the newly created Address `id`.

For more information about this endpoint, see the [API Reference here.](/protect-capital/v3.38/reference/addresses/create).