# Add External Address

<mark style="color:green;">`POST`</mark> `/` `auth/add-external-address`

The request should include crypto address, address name, network and currency in the raw request body.

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |
| Token        | `<token>`          |

**Body**

<table><thead><tr><th width="223">Name</th><th width="192">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>crypto_address</code></td><td>string</td><td>The address of the crypto wallet.</td></tr><tr><td><code>address_name</code></td><td>string</td><td>Address name unique to the specific wallet</td></tr><tr><td><code>network</code></td><td>string</td><td>ETH / TRX</td></tr><tr><td><code>currency</code></td><td>string</td><td>Crypto Currency, i.e USDT / USDT</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="Success Response (New address)" %}

```json
{
    "status": 1,
    "success": true,
    "message": "External Address added successfully",
    "address": "0x5ac166eb3af497020c417fcb",
    "aml_meta": {
        "result": true,
        "balance": 14864,
        "amlFlow": "fast",
        "termsConfirmRequired": false,
        "proMode": "0",
        "discount": 0,
        "discountDueTime": 0,
        "promoFlow": false,
        "data": {
            "signals": {
                "exchange": 0,
                "risky_exchange": 0,
                "p2p_exchange": 0,
                "enforcement_action": 0,
                "atm": 0,
                "child_exploitation": 0,
                "dark_market": 0,
                "dark_service": 0,
                "exchange_fraudulent": 0,
                "gambling": 0,
                "illegal_service": 0,
                "liquidity_pools": 0,
                "marketplace": 0,
                "miner": 0,
                "mixer": 0,
                "other": 0,
                "p2p_exchange_mlrisk_high": 0,
                "payment": 0,
                "ransom": 0,
                "sanctions": 0,
                "scam": 0,
                "seized_assets": 0,
                "stolen_coins": 0,
                "terrorism_financing": 0,
                "wallet": 0,
                "infrastructure_as_a_service": 0,
                "decentralized_exchange_contract": 0,
                "merchant_services": 0,
                "unnamed_service": 0,
                "malware": 0
            },
            "updated_at": 1771918265,
            "address": "03af497020c417fcb",
            "fiat_code_effective": "usd",
            "counterparty": null,
            "reportedAddressBalance": null,
            "addressDetailsData": null,
            "blackListsConnections": false,
            "hasBlackListFlag": false,
            "pdfReport": "https:/api.tumapay.com/reports/report-1771918346489-85ee3a173f6c.pdf",
            "memo": "",
            "customerIsB2B": true,
            "uid": "699d53b9a56ac575769204",
            "asset": "ETH",
            "network": "ETH",
            "status": "success",
            "timestamp": "2026-02-24 07:31:05",
            "flow": "fast",
            "_type": 9,
            "cost": 0
        },
        "pdfReport": "http://localhost:8082/reports/report-1771918346489-85ee3a173f6c.pdf"
    },
}
```

{% endtab %}

{% tab title="Success Response (Existing)" %}

```json
{
    "status": 1,
    "success": true,
    "message": "Address already exists, proceeding with AML check.",
    "id": 123,
    "address": "f497020c417fcb",
    "aml_meta": {
        "result": true,
        "balance": 14864,
        "amlFlow": "fast",
        "termsConfirmRequired": false,
        "proMode": "0",
        "discount": 0,
        "discountDueTime": 0,
        "promoFlow": false,
        "data": {
            "signals": {
                "exchange": 0,
                "risky_exchange": 0,
                "p2p_exchange": 0,
                "enforcement_action": 0,
                "atm": 0,
                "child_exploitation": 0,
                "dark_market": 0,
                "dark_service": 0,
                "exchange_fraudulent": 0,
                "gambling": 0,
                "illegal_service": 0,
                "liquidity_pools": 0,
                "marketplace": 0,
                "miner": 0,
                "mixer": 0,
                "other": 0,
                "p2p_exchange_mlrisk_high": 0,
                "payment": 0,
                "ransom": 0,
                "sanctions": 0,
                "scam": 0,
                "seized_assets": 0,
                "stolen_coins": 0,
                "terrorism_financing": 0,
                "wallet": 0,
                "infrastructure_as_a_service": 0,
                "decentralized_exchange_contract": 0,
                "merchant_services": 0,
                "unnamed_service": 0,
                "malware": 0
            },
            "updated_at": 1771918265,
            "address": "f497020c417fcb",
            "fiat_code_effective": "usd",
            "counterparty": null,
            "reportedAddressBalance": null,
            "addressDetailsData": null,
            "blackListsConnections": false,
            "hasBlackListFlag": false,
            "pdfReport": "http://localhost:8082/reports/report-1771918346489-85ee3a173f6c.pdf",
            "memo": "",
            "customerIsB2B": true,
            "uid": "699d53b9a56ac575769204",
            "asset": "ETH",
            "network": "ETH",
            "status": "success",
            "timestamp": "2026-02-24 07:31:05",
            "flow": "fast",
            "_type": 9,
            "cost": 0
        },
        "pdfReport": "http://localhost:8082/reports/report-1771918346489-85ee3a173f6c.pdf"
    },
}
```

{% endtab %}

{% tab title="Failed Response" %}

```json
{
"status": 0,
"success": true,
"message": "External Address added but AML check failed",
"address": "f497020c4fcb"
}
```

{% endtab %}
{% endtabs %}