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

# Create Wallet

> Create a new currency wallet for your account

Create a new wallet to hold a specific currency. Once created, the wallet appears in your balance list with a zero balance.

```
POST /wallet/create
```

<Note>
  Requires an `Idempotency-Key` header.
</Note>

## Request Body

<ParamField body="currency" type="string" required>
  The currency code for the new wallet (e.g. `COP`, `PEN`, `ARS`, `CLP`).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://api.yativo.com/api/v1/wallet/create' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -H 'Idempotency-Key: unique-key-here' \
    -d '{ "currency": "COP" }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "status": "success",
    "status_code": 201,
    "message": "Wallet created successfully",
    "data": {
      "currency": "COP",
      "balance": "0.00",
      "created_at": "2026-04-01T10:00:00Z"
    }
  }
  ```
</ResponseExample>