> ## 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 SEPA bank account

> Register a European SEPA 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 European SEPA bank account 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">
  IBAN (International Bank Account Number).
</ParamField>

<ParamField body="bic" type="string">
  BIC/SWIFT code.
</ParamField>

<ParamField body="country" type="string">
  ISO 3166-1 alpha-3 country code (e.g., `DEU`, `FRA`, `ESP`).
</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., `USA-CA` for California).
</ParamField>

## Response

See [Create US bank account](/api-reference/management/clients/bank-accounts/create-us-bank-account) for the full field list. SEPA accounts expose `iban` and `bic`.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.cryptomate.me/management/clients/client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/banks/sepa" \
    -H "x-api-key: $CRYPTOMATE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "bank_name": "Deutsche Bank",
      "account_alias": "Primary SEPA Account",
      "bank_holder_first_name": "Hans",
      "bank_holder_last_name": "Mueller",
      "account_number": "DE89370400440532013000",
      "bic": "DEUTDEFF",
      "country": "DEU",
      "address": {
        "streetLine1": "Friedrichstrasse 100",
        "city": "Berlin",
        "postal_code": "10117",
        "state": "DEU-BE",
        "country": "DEU"
      }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "ba_ghi789",
    "client_id": "client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "bank_name": "Deutsche Bank",
    "type": "SEPA",
    "currency": "EUR",
    "iban": "DE89370400440532013000",
    "bic": "DEUTDEFF"
  }
  ```

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

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