---
title: "Create a CA Bank Account"
method: POST
path: "/v2.01/{ClientId}/users/{UserId}/bankaccounts/ca"
tags: ["bankAccounts"]
---

# Create a CA Bank Account

`POST /v2.01/{ClientId}/users/{UserId}/bankaccounts/ca`

<Warning icon="fa-regular fa-triangle-exclamation">
**Caution - Payouts refused to Bank Accounts created after April 30, 2026**

Bank Account objects created after April 30, 2026, will not be usable for payouts. External accounts must be registered using the [Recipient endpoints](/api-reference/recipients/recipient-object) and authenticated using SCA.

Payouts to Bank Accounts created after May 1, 2026, will fail with the `ResultCode` [121018](/errors/codes/121018). To resolve this, register the external account using [POST Create a Recipient](/api-reference/recipients/create-recipient) and retry the payout.
</Warning>

<Note icon="fa-regular fa-circle-info">
**Note – Replaced by Recipients feature**

The Bank Account object and endpoints have been replaced by the Recipients feature, which all platforms should integrate instead.

Legacy active Bank Accounts (`Active` is `true`) have been migrated to the new feature and their data is retrievable via the [GET View a Recipient](/api-reference/recipients/view-recipient) endpoint using the same `BankAccountId`. Read more about [legacy bank account migration](/guides/payouts#migration-of-legacy-bank-accounts).
</Note>

Create a CA Bank Account

## Path parameters

- `ClientId` string, required
- `UserId` string, required

## Headers

- `Authorization` string, required

## Request body

- CreateACABankAccountRequest
  - `OwnerAddress` AddressPlatformHeadquarters, required — The address of the platform operator's headquarters. This parameter must be provided for the platform's payouts to be processed.
    - `AddressLine1` string, required — The first line of the address.
    - `AddressLine2` string — The second line of the address.
    - `City` string, required — The city of the address.
    - `Region` string — Required if `Country` is US, CA, or MX. The region of the address.
    - `PostalCode` string, required — Required if `HeadquarterAddress` is sent. The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.
    - `Country` string, required — Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The country of the address.
  - `AccountNumber` string, required — Format: Digits only The unique number of the bank account (between 7 to 35 digits).
  - `InstitutionNumber` string, required — Length: 3 digits The 3-digit number assigned to Canadian financial institutions, for CA-type bank accounts.
  - `BranchCode` string, required — Length: 5 digits The 5-digit number assigned to branches of Canadian financial institutions, for CA-type bank accounts.
  - `BankName` string, required — Max. length: 50 characters (letters and digits only) The name of the Canadian bank for CA-type bank accounts.
  - `OwnerName` string, required — Max. length: 255 characters The full name of the owner of the bank account. (Format: FirstName LastName)
  - `Tag` string — Max. length: 255 characters Custom data that you can add to this object.

## Response `200`

Success

- CreateACABankAccountResponse
  - `OwnerAddress` Address — The postal address.
    - `AddressLine1` string — The first line of the address.
    - `AddressLine2` string — The second line of the address.
    - `City` string — The city of the address.
    - `Region` string — Required if `Country` is US, CA, or MX. The region of the address.
    - `PostalCode` string — The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.
    - `Country` string — Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The country of the address.
  - `AccountNumber` string — Format: Digits only The unique number of the bank account (between 7 to 35 digits).
  - `InstitutionNumber` string — Length: 3 digits The 3-digit number assigned to Canadian financial institutions, for CA-type bank accounts.
  - `BranchCode` string — Length: 5 digits The 5-digit number assigned to branches of Canadian financial institutions, for CA-type bank accounts.
  - `BankName` string — Max. length: 50 characters (letters and digits only) The name of the Canadian bank for CA-type bank accounts.
  - `UserId` string — The unique identifier of the User (natural or legal) who owns the bank account.
  - `OwnerName` string — Max. length: 255 characters The full name of the owner of the bank account. (Format: FirstName LastName)
  - `Type` string — **Returned values:** `IBAN`, `US`, `CA`, `GB`, `OTHER` The type of the bank account, indicating the country where the real-life account is registered The values are: - `IBAN` – For accounts registered in countries that use IBAN - `US` – For accounts registered in the United States - `CA` – For accounts registered in Canada - `GB` – For accounts registered in the United Kingdom - `OTHER` – For accounts registered in countries that do not use IBAN (and are not US, CA, GB)
  - `Id` string — Max length: 128 characters (see [data formats](/api-reference/overview/data-formats) for details) The unique identifier of the object.
  - `Tag` string — Max. length: 255 characters Custom data that you can add to this object.
  - `CreationDate` integer — Unix timestamp (UTC) of the date and time the object was created.
  - `Active` boolean — Whether or not the Bank Account is active. Mangopay automatically sets this parameter to `false` if the bank account is closed or does not exist anymore.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/mangopay/apis/api-reference.md) · [All operations](https://skmtc.dev/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mangopay/api-reference/revisions/fafbd0c69654/schema)