First connection - Fintoro API

Create an API token and check the connection by fetching the company name.

1. Create an API token

In Fintoro, select the company and open Automatizácie → Fintoro API.
Click Vytvoriť API kľúč (Create API key) and enter a name.
Select Read only (read) to read data, or Read + Write (write) to read, write, and delete data.
Copy the token and store it securely. It is only shown when created.

For isolated testing, you can create a sandbox company. Then create the token in that company.

2. Check the connection

Replace <company-token> with your token and call GET /whoami:

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/whoami \
  --header 'Authorization: Bearer <company-token>' \
  --header 'Accept: application/json'

A valid token returns 200 OK with the company name. Illustrative response:

{
  "name": "Acme s.r.o."
}

Check that the name matches the company you want to work with. If you receive 401, check the token and the Authorization header; see API tokens for details.