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

# Create CO Bank Transfer bank account

> Register a Colombian CO Bank Transfer (PSE) bank account for a client.

<Warning>
  **Deprecated.** This endpoint is no longer available in the public API and is kept for reference only.
</Warning>

Creates a new Colombian CO Bank Transfer bank account (COP) for the specified client. Supports both individual and business clients via mutually exclusive holder name fields. Requires an API key with access level 3 or higher.

## Path parameters

<ParamField path="clientId" type="string" required>
  Unique identifier of the client.
</ParamField>

## Body

<ParamField body="bank_name" type="string">
  Name of the bank.
</ParamField>

<ParamField body="account_alias" type="string">
  User-friendly alias for the account.
</ParamField>

<ParamField body="bank_holder_first_name" type="string">
  Account holder's first name. Required for individual clients; mutually exclusive with `business_name`.
</ParamField>

<ParamField body="bank_holder_last_name" type="string">
  Account holder's last name. Required for individual clients; mutually exclusive with `business_name`.
</ParamField>

<ParamField body="business_name" type="string">
  Business name. Required for business clients; mutually exclusive with `bank_holder_first_name` + `bank_holder_last_name`.
</ParamField>

<ParamField body="account_number" type="string">
  Colombian bank account number.
</ParamField>

<ParamField body="bank_code" type="string">
  Colombian bank code. See [List Colombian bank codes](/api-reference/management/clients/bank-accounts/list-colombian-bank-codes) for accepted values.
</ParamField>

<ParamField body="co_account_type" type="string">
  Colombian account sub-type. One of `checking`, `savings`, `electronic_deposit`. See [List CO account types](/api-reference/management/clients/bank-accounts/list-co-account-types).
</ParamField>

<ParamField body="document_type" type="string">
  Colombian document type identifier. Common values: `cc` (Cédula de Ciudadanía), `ce` (Cédula de Extranjería), `nit` (business tax ID), `rut` (worker registration).
</ParamField>

<ParamField body="document_number" type="string">
  Document number of the account holder.
</ParamField>

<ParamField body="phone_number" type="string">
  Phone number of the account holder in E.164 format (e.g., `+573001234567`).
</ParamField>

<ParamField body="address" type="object">
  Account holder's address with `street_line_1`, `street_line_2`, `city`, `postal_code`, `state`, `country`.

  `state` uses ISO 3166-2 codes that identify country subdivisions in the format `{COUNTRY}-{SUBDIVISION}` (e.g., `COL-DC` for Bogotá D.C.).
</ParamField>

## Response

See [Create US bank account](/api-reference/management/clients/bank-accounts/create-us-bank-account) for the shared field list. CO Bank Transfer accounts expose `bank_code`, `co_account_type`, `document_type`, `document_number`, `phone_number`, and `business_name` when applicable. The `type` is `CO_BANK_TRANSFER` and the `currency` is `COP`.

<RequestExample>
  ```bash cURL (individual) theme={null}
  curl -X POST "https://api.cryptomate.me/management/clients/client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/banks/co-bank-transfer" \
    -H "x-api-key: $CRYPTOMATE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "bank_name": "Bancolombia",
      "account_alias": "Cuenta COP principal",
      "bank_holder_first_name": "María",
      "bank_holder_last_name": "López",
      "account_number": "12345678901234",
      "bank_code": "1007",
      "co_account_type": "savings",
      "document_type": "cc",
      "document_number": "1234567890",
      "phone_number": "+573001234567",
      "address": {
        "street_line_1": "Carrera 7 # 71-21",
        "city": "Bogotá",
        "postal_code": "110231",
        "state": "COL-DC",
        "country": "COL"
      }
    }'
  ```

  ```bash cURL (business) theme={null}
  curl -X POST "https://api.cryptomate.me/management/clients/client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/banks/co-bank-transfer" \
    -H "x-api-key: $CRYPTOMATE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "bank_name": "Bancolombia",
      "account_alias": "Cuenta empresa COP",
      "business_name": "ACME Colombia SAS",
      "account_number": "98765432109876",
      "bank_code": "1007",
      "co_account_type": "checking",
      "document_type": "nit",
      "document_number": "9001234567",
      "phone_number": "+573001234567",
      "address": {
        "street_line_1": "Carrera 7 # 71-21",
        "city": "Bogotá",
        "postal_code": "110231",
        "state": "COL-DC",
        "country": "COL"
      }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "id": "ba_co_abc123",
    "company_id": "comp_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23",
    "client_id": "client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "bank_name": "Bancolombia",
    "bank_holder_name": "María López",
    "account_alias": "Cuenta COP principal",
    "type": "CO_BANK_TRANSFER",
    "currency": "COP",
    "bank_code": "1007",
    "co_account_type": "savings",
    "document_type": "cc",
    "document_number": "1234567890",
    "phone_number": "+573001234567"
  }
  ```

  ```json 400 Owner Fields Invalid theme={null}
  {
    "code": "VAL",
    "message": "Must provide either (bankHolderFirstName + bankHolderLastName) for individual or businessName for business"
  }
  ```

  ```json 403 Missing Endorsements theme={null}
  {
    "code": "APP_ERROR",
    "message": "Customer is missing required endorsements: cop"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "code": "NOT_FOUND",
    "message": "Client does not have a customer ID for provider BRIDGE"
  }
  ```
</ResponseExample>