BizKitHub
DocsAPI ReferenceTransaction/bff/transaction/add-api-token
postTransactionAdmin BFF

/bff/transaction/add-api-token

Adds a new Fio bank account by API token. The token is validated for uniqueness and the account is created immediately with its connector in pending state; the first sync (IBAN discovery + transaction import) runs in the background with retries around the Fio 30 s rate limit. Poll GET /bff/bank-account and watch connectorLastStatus (pending → success / error). Throws if the token is malformed or already connected.

TransactionpostBffTransactionAdd-api-token

Parameters

JSON body

Request body

application/json
apiTokenstringRequired

Fio bank API token (from internetbanking settings).

Exampleabcdef1234567890
displayNamestringOptional

Optional user-facing label for the account.

Length: 0–128
ExampleSpořicí účet

Response schema

1 status code documented

200Success
successbooleanRequired

Whether the token was accepted.

externalIdstringRequired

External ID of the newly created bank account.

status"pending"Required

Connector state right after the call.

Response example

application/json
{
  "success": false,
  "externalId": "example_externalId",
  "status": "pending"
}

Request example

POST /bff/transaction/add-api-token

post
curl -X POST "https://api.bizkithub.com/bff/transaction/add-api-token" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "apiToken": "abcdef1234567890",
  "displayName": "Spořicí účet"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key