Create bank account

POST

bank-accounts

Create bank account

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/bank-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Main account",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "bankId": 1,
  "autoPairingStrategy": "by_variable_symbol"
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/bank-accounts"

payload = {
    "name": "Main account",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "bankId": 1,
    "autoPairingStrategy": "by_variable_symbol"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Main account',
    iban: 'SK3111000000001234567890',
    swift: 'TATRSKBX',
    bankId: 1,
    autoPairingStrategy: 'by_variable_symbol'
  })
};

fetch('https://app.fintoro.sk/api/public/v1/bank-accounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/bank-accounts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Main account',
    'iban' => 'SK3111000000001234567890',
    'swift' => 'TATRSKBX',
    'bankId' => 1,
    'autoPairingStrategy' => 'by_variable_symbol'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fintoro.sk/api/public/v1/bank-accounts"

	payload := strings.NewReader("{\n  \"name\": \"Main account\",\n  \"iban\": \"SK3111000000001234567890\",\n  \"swift\": \"TATRSKBX\",\n  \"bankId\": 1,\n  \"autoPairingStrategy\": \"by_variable_symbol\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.fintoro.sk/api/public/v1/bank-accounts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Main account\",\n  \"iban\": \"SK3111000000001234567890\",\n  \"swift\": \"TATRSKBX\",\n  \"bankId\": 1,\n  \"autoPairingStrategy\": \"by_variable_symbol\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/bank-accounts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Main account\",\n  \"iban\": \"SK3111000000001234567890\",\n  \"swift\": \"TATRSKBX\",\n  \"bankId\": 1,\n  \"autoPairingStrategy\": \"by_variable_symbol\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": 201,
  "bankId": 1,
  "bank": {
    "id": 23,
    "name": "Tatra Banka",
    "swift": "TATRSKBX"
  },
  "isPrimary": true,
  "autoPaymentMatching": true,
  "name": "Main account",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "autoPairingStrategy": "by_variable_symbol",
  "balance": 1234.56,
  "lastSyncedAt": "2026-03-01 10:15:16",
  "openBankingValidUntil": "2026-04-30",
  "createdAt": "2026-03-03 12:00:00",
  "updatedAt": "2026-03-03 15:45:00"
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Authorizations

Authorization

string

header

required

Bearer token created for a specific company in Integrations → API.

Body

application/json

Payload used to create a bank account. Send only the business fields of the account. Fields with backend defaults are derived on the server side when omitted.

name

string

required

Bank account name you want to use inside Fintoro.

Maximum string length: 255

Example:

"Main account"

iban

string

required

IBAN of the bank account. It must be valid and unique within the token scope.

Example:

"SK3111000000001234567890"

swift

string

required

SWIFT or BIC code of the bank account.

Maximum string length: 255

Example:

"TATRSKBX"

bankId

integer | null

Optional bank ID from the banks lookup endpoint. Use it when you want to link the account to a specific bank from the public lookup.

Example:

1

autoPairingStrategy

enum<string>

default:by_variable_symbol

Automatic payment pairing strategy for this account. If omitted, the default value by_variable_symbol is used.

Available options:

none,

by_variable_symbol,

by_price,

by_variable_symbol_and_price,

by_all_symbols,

by_all_symbols_and_price

Example:

"by_variable_symbol"

Response

Bank account created.

Bank account. This object combines the business account fields, bank details, and open banking state.

integer

Internal Fintoro bank account ID.

Example:

201

bankId

integer | null

Bank ID from the banks lookup endpoint. If null, the account is not linked to a known bank from the public lookup.

Example:

1

bank

object | null

Nested bank object corresponding to bankId, when the bank is known and still available in the lookup dataset.

Show child attributes

isPrimary

boolean

Indicates whether this account is currently marked as the company's primary bank account.

Example:

true

autoPaymentMatching

boolean

Indicates whether the account is currently connected to automatic payment matching through open banking. This value is derived from the presence of an open banking connection and is never sent in the request payload.

Example:

true

name

string

User-facing bank account name shown in Fintoro.

Example:

"Main account"

iban

string

Bank account IBAN.

Example:

"SK3111000000001234567890"

swift

string

SWIFT or BIC code of the bank account.

Example:

"TATRSKBX"

autoPairingStrategy

enum<string>

Automatic payment pairing strategy used for this bank account.

Available options:

none,

by_variable_symbol,

by_price,

by_variable_symbol_and_price,

by_all_symbols,

by_all_symbols_and_price

Example:

"by_variable_symbol"

balance

number<float> | null

Last known account balance, when available from open banking.

Example:

1234.56

lastSyncedAt

string | null

Date and time of the last successful open banking sync, when available.

Example:

"2026-03-01 10:15:16"

openBankingValidUntil

string<date> | null

Date until which the current open banking consent remains valid, if present.

Example:

"2026-04-30"

createdAt

string | null

Date and time when the bank account was created.

Example:

"2026-03-03 12:00:00"

updatedAt

string | null

Date and time of the most recent bank account change.

Example:

"2026-03-03 15:45:00"

Create bank account

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/bank-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Main account",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "bankId": 1,
  "autoPairingStrategy": "by_variable_symbol"
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/bank-accounts"

payload = {
    "name": "Main account",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "bankId": 1,
    "autoPairingStrategy": "by_variable_symbol"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Main account',
    iban: 'SK3111000000001234567890',
    swift: 'TATRSKBX',
    bankId: 1,
    autoPairingStrategy: 'by_variable_symbol'
  })
};

fetch('https://app.fintoro.sk/api/public/v1/bank-accounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/bank-accounts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Main account',
    'iban' => 'SK3111000000001234567890',
    'swift' => 'TATRSKBX',
    'bankId' => 1,
    'autoPairingStrategy' => 'by_variable_symbol'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fintoro.sk/api/public/v1/bank-accounts"

	payload := strings.NewReader("{\n  \"name\": \"Main account\",\n  \"iban\": \"SK3111000000001234567890\",\n  \"swift\": \"TATRSKBX\",\n  \"bankId\": 1,\n  \"autoPairingStrategy\": \"by_variable_symbol\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.fintoro.sk/api/public/v1/bank-accounts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Main account\",\n  \"iban\": \"SK3111000000001234567890\",\n  \"swift\": \"TATRSKBX\",\n  \"bankId\": 1,\n  \"autoPairingStrategy\": \"by_variable_symbol\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/bank-accounts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Main account\",\n  \"iban\": \"SK3111000000001234567890\",\n  \"swift\": \"TATRSKBX\",\n  \"bankId\": 1,\n  \"autoPairingStrategy\": \"by_variable_symbol\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": 201,
  "bankId": 1,
  "bank": {
    "id": 23,
    "name": "Tatra Banka",
    "swift": "TATRSKBX"
  },
  "isPrimary": true,
  "autoPaymentMatching": true,
  "name": "Main account",
  "iban": "SK3111000000001234567890",
  "swift": "TATRSKBX",
  "autoPairingStrategy": "by_variable_symbol",
  "balance": 1234.56,
  "lastSyncedAt": "2026-03-01 10:15:16",
  "openBankingValidUntil": "2026-04-30",
  "createdAt": "2026-03-03 12:00:00",
  "updatedAt": "2026-03-03 15:45:00"
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Overview

Endpoints

Authorizations

Body

Response