> For the complete documentation index, see [llms.txt](https://developer.convergegate.com/legacy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.convergegate.com/legacy/token-api/tokens/create-a-bank-account-token.md).

# Create a Bank Account Token

<mark style="color:yellow;">`POST`</mark>` ``/v1/tokens`

{% tabs %}
{% tab title="CURL" %}

```
curl https://testapi.txpmnts.com/v1/tokens \
  -u sk_test_yFStF-KUmgr-7CoumuY2JA: \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d "bank_account[country]"=US \
  -d "bank_account[currency]"=USD \
  -d "bank_account[account_holder_name]"="John Doe" \
  -d "bank_account[account_holder_type]"=individual \
  -d "bank_account[routing_number]"=110000000 \
  -d "bank_account[account_number]"=000123456789
```

{% endtab %}
{% endtabs %}

This above command returns a JSON structure like this:

```json
{
	"id": "9TDphrhSQ9mHsFztnRxXbg",
	"bank_account": {
		"account_holder_name": "John Doe",
		"account_holder_type": "individual",
		"country": "PL",
		"currency": "EUR",
		"swift_code": "",
		"last4": "6789",
		"routing_number": "110000000"
	},
	"fingerprint": "R1gbK7BauiX3XdnUCQRhzlnvMxxtSKVS7NqScFBeVRE",
	"client_ip": "127.0.0.1",
	"created_at": 1568895704,
	"type": "bank_account"
}
```

## Arguments <a href="#arguments-1" id="arguments-1"></a>

Contains the bank account information to be stored.

| Parameter                             | Type    | Requiered   | Description                                                                                                                                                                        |
| ------------------------------------- | ------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| bank\_account\[currency]              | string  | optional    | The currency the bank acount is in.                                                                                                                                                |
| bank\_account\[country]               | string  | required    | The country in which the bank account is located.                                                                                                                                  |
| bank\_account\[account\_holder\_name] | string  | optional    | The name of the person or business that owns the bank account. This field is required when attaching the bank account to a ***Customer*** object.                                  |
| bank\_account\[account\_holder\_type] | string  | optional    | The type of entity that holds the account. This can be either ***individual***, ***company***. This fields is required when attaching the bank account to a ***Customer*** object. |
| bank\_account\[routing\_number]       | string  | conditional | The routing number, short code, or other country-appropriate institution number for the bank account.                                                                              |
| bank\_account\[account\_number]       | string  | required    | The account number for the bank account, in string formaat. Must be a checking account.                                                                                            |
| bank\_account\[saving]                | boolean | optional    | True if the account is from saving.                                                                                                                                                |
| bank\_account\[bank\_name]            | string  | optional    | The name of the financial institution that the account belongs to.                                                                                                                 |
| bank\_account\[swift\_code]           | string  | optional    | The account swift code for international transfers.                                                                                                                                |

## Returns <a href="#returns-1" id="returns-1"></a>

Returns the created bank account token if successful. Otherwise, this call returns an error.