---
title: "Create a bank connection"
method: PUT
path: "/api/connections"
tags: ["XS2A.api.connections"]
---

# Create a bank connection

`PUT /api/connections`

Create a bank connection and receive wizard session object

## Request body

- Xs2aApiConnections
  - `sync_mode` 'full' | 'shared' | 'none' — The mode how the bank connection is synced.
  - `bic` string — The BIC of the bank, if known already.
  - `country_id` 'DE' | 'AT' | 'CH' — The 2-letter country code
  - `days` integer — Number of days for collecting turnovers from bank account
  - `limit_days` integer — Number of days to limit the resulting account. After every sync the account will be limited to that amount of days.
  - `account_selection` 'all' | 'multi' | 'single' — Mode of account selection. If "all" is given, all available accounts from this bankconnection will be used. If "single"/"multi" is given, the customer can pick single/multiple accounts from this connection which will be used.
  - `language` 'de' | 'en' — Desired language in which the customer interface will be rendered with.
  - `fints_product_id` string — The fints product ID can be enclosed in the initial request. If you have an eIDAS certificate, then you have to send it with every request.

## Response `200`

Request successfully processed

- WizardSessionResponse
  - `wizard_session_key` string — Using the wizard_session_key you can now initialize our Wizard which is running on your website
  - `transaction` string — We suggest that you store the internally used XS2A transaction id transaction with your transaction data, because if you later have questions about a transaction, we need this number to be able to quickly assist you.

## Other responses

- `401` — Authentication failed API key missing or not valid
- `403` — Forbidden Access blocked
- `404` — Product not enabled or Not found The requested object does not exist on the server
- `422` — Validation failed Something is wrong with the user input
- `500` — An internal server problem occurred

---

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