Vytvoriť klienta

POST

clients

Vytvoriť klienta

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/clients \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme s.r.o.",
  "type": "company",
  "subjectId": "12345678",
  "taxId": "2020123456",
  "vatId": "SK2020123456",
  "isVatPayer": true,
  "email": "billing@acme.test",
  "street": "Hlavná 1",
  "city": "Bratislava",
  "zip": "81101",
  "countryId": 703,
  "deliveryStreet": "Skladová 9",
  "deliveryCity": "Košice",
  "deliveryZip": "04001",
  "deliveryCountryId": 703,
  "preferredDeliveryMethodId": 1,
  "preferredPaymentMethodId": 1,
  "preferredCurrencyId": 1,
  "preferredLanguageId": 1,
  "preferredDueDays": 14,
  "preferredNote": "Splatnosť 14 dní.",
  "stripeCustomerId": "cus_public_api_123",
  "systemeioContactId": 123456,
  "preferredVariableSymbol": 2026001,
  "preferredConstantSymbol": 308,
  "preferredSpecificSymbol": 55,
  "preferredTextAboveItems": "Dakujeme za spoluprácu."
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/clients"

payload = {
    "name": "Acme s.r.o.",
    "type": "company",
    "subjectId": "12345678",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "isVatPayer": True,
    "email": "billing@acme.test",
    "street": "Hlavná 1",
    "city": "Bratislava",
    "zip": "81101",
    "countryId": 703,
    "deliveryStreet": "Skladová 9",
    "deliveryCity": "Košice",
    "deliveryZip": "04001",
    "deliveryCountryId": 703,
    "preferredDeliveryMethodId": 1,
    "preferredPaymentMethodId": 1,
    "preferredCurrencyId": 1,
    "preferredLanguageId": 1,
    "preferredDueDays": 14,
    "preferredNote": "Splatnosť 14 dní.",
    "stripeCustomerId": "cus_public_api_123",
    "systemeioContactId": 123456,
    "preferredVariableSymbol": 2026001,
    "preferredConstantSymbol": 308,
    "preferredSpecificSymbol": 55,
    "preferredTextAboveItems": "Dakujeme za spoluprácu."
}
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: 'Acme s.r.o.',
    type: 'company',
    subjectId: '12345678',
    taxId: '2020123456',
    vatId: 'SK2020123456',
    isVatPayer: true,
    email: 'billing@acme.test',
    street: 'Hlavná 1',
    city: 'Bratislava',
    zip: '81101',
    countryId: 703,
    deliveryStreet: 'Skladová 9',
    deliveryCity: 'Košice',
    deliveryZip: '04001',
    deliveryCountryId: 703,
    preferredDeliveryMethodId: 1,
    preferredPaymentMethodId: 1,
    preferredCurrencyId: 1,
    preferredLanguageId: 1,
    preferredDueDays: 14,
    preferredNote: 'Splatnosť 14 dní.',
    stripeCustomerId: 'cus_public_api_123',
    systemeioContactId: 123456,
    preferredVariableSymbol: 2026001,
    preferredConstantSymbol: 308,
    preferredSpecificSymbol: 55,
    preferredTextAboveItems: 'Dakujeme za spoluprácu.'
  })
};

fetch('https://app.fintoro.sk/api/public/v1/clients', 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/clients",
  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' => 'Acme s.r.o.',
    'type' => 'company',
    'subjectId' => '12345678',
    'taxId' => '2020123456',
    'vatId' => 'SK2020123456',
    'isVatPayer' => true,
    'email' => 'billing@acme.test',
    'street' => 'Hlavná 1',
    'city' => 'Bratislava',
    'zip' => '81101',
    'countryId' => 703,
    'deliveryStreet' => 'Skladová 9',
    'deliveryCity' => 'Košice',
    'deliveryZip' => '04001',
    'deliveryCountryId' => 703,
    'preferredDeliveryMethodId' => 1,
    'preferredPaymentMethodId' => 1,
    'preferredCurrencyId' => 1,
    'preferredLanguageId' => 1,
    'preferredDueDays' => 14,
    'preferredNote' => 'Splatnosť 14 dní.',
    'stripeCustomerId' => 'cus_public_api_123',
    'systemeioContactId' => 123456,
    'preferredVariableSymbol' => 2026001,
    'preferredConstantSymbol' => 308,
    'preferredSpecificSymbol' => 55,
    'preferredTextAboveItems' => 'Dakujeme za spoluprácu.'
  ]),
  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/clients"

	payload := strings.NewReader("{\n  \"name\": \"Acme s.r.o.\",\n  \"type\": \"company\",\n  \"subjectId\": \"12345678\",\n  \"taxId\": \"2020123456\",\n  \"vatId\": \"SK2020123456\",\n  \"isVatPayer\": true,\n  \"email\": \"billing@acme.test\",\n  \"street\": \"Hlavná 1\",\n  \"city\": \"Bratislava\",\n  \"zip\": \"81101\",\n  \"countryId\": 703,\n  \"deliveryStreet\": \"Skladová 9\",\n  \"deliveryCity\": \"Košice\",\n  \"deliveryZip\": \"04001\",\n  \"deliveryCountryId\": 703,\n  \"preferredDeliveryMethodId\": 1,\n  \"preferredPaymentMethodId\": 1,\n  \"preferredCurrencyId\": 1,\n  \"preferredLanguageId\": 1,\n  \"preferredDueDays\": 14,\n  \"preferredNote\": \"Splatnosť 14 dní.\",\n  \"stripeCustomerId\": \"cus_public_api_123\",\n  \"systemeioContactId\": 123456,\n  \"preferredVariableSymbol\": 2026001,\n  \"preferredConstantSymbol\": 308,\n  \"preferredSpecificSymbol\": 55,\n  \"preferredTextAboveItems\": \"Dakujeme za spoluprácu.\"\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/clients")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Acme s.r.o.\",\n  \"type\": \"company\",\n  \"subjectId\": \"12345678\",\n  \"taxId\": \"2020123456\",\n  \"vatId\": \"SK2020123456\",\n  \"isVatPayer\": true,\n  \"email\": \"billing@acme.test\",\n  \"street\": \"Hlavná 1\",\n  \"city\": \"Bratislava\",\n  \"zip\": \"81101\",\n  \"countryId\": 703,\n  \"deliveryStreet\": \"Skladová 9\",\n  \"deliveryCity\": \"Košice\",\n  \"deliveryZip\": \"04001\",\n  \"deliveryCountryId\": 703,\n  \"preferredDeliveryMethodId\": 1,\n  \"preferredPaymentMethodId\": 1,\n  \"preferredCurrencyId\": 1,\n  \"preferredLanguageId\": 1,\n  \"preferredDueDays\": 14,\n  \"preferredNote\": \"Splatnosť 14 dní.\",\n  \"stripeCustomerId\": \"cus_public_api_123\",\n  \"systemeioContactId\": 123456,\n  \"preferredVariableSymbol\": 2026001,\n  \"preferredConstantSymbol\": 308,\n  \"preferredSpecificSymbol\": 55,\n  \"preferredTextAboveItems\": \"Dakujeme za spoluprácu.\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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\": \"Acme s.r.o.\",\n  \"type\": \"company\",\n  \"subjectId\": \"12345678\",\n  \"taxId\": \"2020123456\",\n  \"vatId\": \"SK2020123456\",\n  \"isVatPayer\": true,\n  \"email\": \"billing@acme.test\",\n  \"street\": \"Hlavná 1\",\n  \"city\": \"Bratislava\",\n  \"zip\": \"81101\",\n  \"countryId\": 703,\n  \"deliveryStreet\": \"Skladová 9\",\n  \"deliveryCity\": \"Košice\",\n  \"deliveryZip\": \"04001\",\n  \"deliveryCountryId\": 703,\n  \"preferredDeliveryMethodId\": 1,\n  \"preferredPaymentMethodId\": 1,\n  \"preferredCurrencyId\": 1,\n  \"preferredLanguageId\": 1,\n  \"preferredDueDays\": 14,\n  \"preferredNote\": \"Splatnosť 14 dní.\",\n  \"stripeCustomerId\": \"cus_public_api_123\",\n  \"systemeioContactId\": 123456,\n  \"preferredVariableSymbol\": 2026001,\n  \"preferredConstantSymbol\": 308,\n  \"preferredSpecificSymbol\": 55,\n  \"preferredTextAboveItems\": \"Dakujeme za spoluprácu.\"\n}"

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

{
  "id": 101,
  "name": "Acme s.r.o.",
  "type": "company",
  "subjectId": "12345678",
  "taxId": "2020123456",
  "vatId": "SK2020123456",
  "isVatPayer": true,
  "email": "billing@acme.test",
  "street": "Hlavná 1",
  "city": "Bratislava",
  "zip": "81101",
  "country": {
    "id": 703,
    "name": "Slovensko",
    "code": "SK",
    "eu": true
  },
  "hasDeliveryAddress": true,
  "deliveryStreet": "Skladová 9",
  "deliveryCity": "Košice",
  "deliveryZip": "04001",
  "deliveryCountry": {
    "id": 703,
    "name": "Slovensko",
    "code": "SK",
    "eu": true
  },
  "createdAt": "2026-03-03T12:00:00+01:00",
  "updatedAt": "2026-03-03T15:45:00+01:00",
  "preferredDeliveryMethodId": 1,
  "preferredPaymentMethodId": 1,
  "preferredCurrencyId": 1,
  "preferredLanguageId": 1,
  "preferredDueDays": 14,
  "preferredNote": "Splatnosť 14 dní.",
  "preferredVariableSymbol": 2026001,
  "preferredConstantSymbol": 308,
  "preferredSpecificSymbol": 55,
  "preferredTextAboveItems": "Dakujeme za spoluprácu."
}

{
  "error": "Idempotency-Key reused with different request payload"
}

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

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Autorizace

Authorization

string

header

povinné

Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.

Hlavičky

Idempotency-Key

string

Voliteľný identifikátor requestu pre bezpečné retry. Použite unikátnu hodnotu pre každé create volanie, ktoré chcete vedieť bezpečne zopakovať.

Příklad:

"invoice-create-2026-03-03-001"

Tělo

application/json

Payload pre vytvorenie klienta. Pošlite business dáta klienta a voliteľné klientské predvolené hodnoty, ktoré sa uložia ako fallback defaulty pre tvorbu nových dokladov.

name

string

povinné

Meno osoby alebo obchodné meno klienta. Pole je pri vytvorení povinné.

Maximum string length: 255

Příklad:

"Acme s.r.o."

type

enum<string>

výchozí:person

Voliteľný typ klienta. Povolené hodnoty sú person a company. Ak ho nepošlete, použije sa person, prípadne company, ak pošlete subjectId, taxId alebo vatId.

Dostupné možnosti:

person,

company

Příklad:

"company"

subjectId

string | null

IČO klienta alebo firmy. Pre slovenské subjekty túto hodnotu viete typicky dohľadať aj cez referenčný register subjektov.

Maximum string length: 40

Příklad:

"12345678"

taxId

string | null

DIČ klienta.

Maximum string length: 40

Příklad:

"2020123456"

vatId

string | null

IČ DPH klienta.

Maximum string length: 40

Příklad:

"SK2020123456"

isVatPayer

boolean

Voliteľná informácia, či je klient platca DPH. Ak ju nepošlete a vyplníte vatId, nastaví sa automaticky na true.

Příklad:

true

string<email> | null

Kontaktný e-mail klienta.

Maximum string length: 255

Příklad:

"billing@acme.test"

street

string | null

Ulica a číslo fakturačnej adresy.

Maximum string length: 255

Příklad:

"Hlavná 1"

city

string | null

Mesto fakturačnej adresy.

Maximum string length: 255

Příklad:

"Bratislava"

zip

string | null

PSČ fakturačnej adresy.

Maximum string length: 10

Příklad:

"81101"

countryId

integer | null

ID fakturačnej krajiny z referenčnej tabuľky krajín.

Příklad:

703

deliveryStreet

string | null

Ulica a číslo dodacej adresy. Ak pošlete ktorúkoľvek hodnotu z dodacej adresy, hasDeliveryAddress sa nastaví automaticky.

Maximum string length: 255

Příklad:

"Skladová 9"

deliveryCity

string | null

Mesto dodacej adresy. Ak pošlete ktorúkoľvek hodnotu z dodacej adresy, hasDeliveryAddress sa nastaví automaticky.

Maximum string length: 255

Příklad:

"Košice"

deliveryZip

string | null

PSČ dodacej adresy. Ak pošlete ktorúkoľvek hodnotu z dodacej adresy, hasDeliveryAddress sa nastaví automaticky.

Maximum string length: 10

Příklad:

"04001"

deliveryCountryId

integer | null

ID krajiny dodacej adresy z referenčnej tabuľky krajín. Ak pošlete ktorúkoľvek hodnotu z dodacej adresy, hasDeliveryAddress sa nastaví automaticky.

Příklad:

703

preferredDeliveryMethodId

integer | null

Predvolená hodnota spôsobu dodania pre klienta. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z referenčnej tabuľky spôsobov dodania.

Příklad:

1

preferredPaymentMethodId

integer | null

Predvolená hodnota spôsobu úhrady pre klienta. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z referenčnej tabuľky spôsobov úhrady.

Příklad:

1

preferredCurrencyId

integer | null

Predvolená hodnota meny pre klienta. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z referenčnej tabuľky mien.

Příklad:

1

preferredLanguageId

integer | null

Predvolená hodnota jazyka pre klienta. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z referenčnej tabuľky jazykov.

Příklad:

1

preferredDueDays

integer | null

Predvolený počet dní splatnosti. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.

Požadovaný rozsah: 0 <= x <= 365

Příklad:

14

preferredNote

string | null

Predvolená poznámka. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.

Příklad:

"Splatnosť 14 dní."

stripeCustomerId

string | null

Externé ID zákazníka v Stripe, ak si ho pri klientovi evidujete.

Maximum string length: 255

Příklad:

"cus_public_api_123"

systemeioContactId

integer | null

Externé ID kontaktu v Systeme.io, ak si ho pri klientovi evidujete.

Příklad:

123456

preferredVariableSymbol

integer | null

Predvolený variabilný symbol. Povolené sú hodnoty s dĺžkou 1 až 10 číslic.

Požadovaný rozsah: 0 <= x <= 9999999999

Příklad:

2026001

preferredConstantSymbol

integer | null

Predvolený konštantný symbol. Povolené sú hodnoty s dĺžkou 1 až 4 číslic.

Požadovaný rozsah: 0 <= x <= 9999

Příklad:

308

preferredSpecificSymbol

integer | null

Predvolený špecifický symbol. Povolené sú hodnoty s dĺžkou 1 až 10 číslic.

Požadovaný rozsah: 0 <= x <= 9999999999

Příklad:

55

preferredTextAboveItems

string | null

Predvolený text nad položkami. Ukladá sa pri klientovi a pri tvorbe nových dokladov pre tohto klienta sa používa ako fallback default, ak explicitnú hodnotu nepošlete v payloade.

Maximum string length: 3000

Příklad:

"Dakujeme za spoluprácu."

Odpověď

Klient bol vytvorený.

Klient vrátane klientských predvolených hodnôt. Tieto hodnoty neaplikuje API automaticky, ale môžete ich použiť ako odporúčaný default pri skladaní payloadov nových dokladov.

integer

Interné ID klienta vo Fintoro.

Příklad:

101

name

string

Meno osoby alebo obchodné meno klienta.

Příklad:

"Acme s.r.o."

type

enum<string>

Typ klienta. Hodnota person reprezentuje fyzickú osobu, hodnota company firmu alebo živnostníka evidovaného ako podnikateľský subjekt.

Dostupné možnosti:

person,

company

Příklad:

"company"

subjectId

string | null

IČO klienta alebo firmy. Pre slovenské subjekty túto hodnotu viete typicky dohľadať aj cez referenčný register subjektov.

Příklad:

"12345678"

taxId

string | null

DIČ klienta, ak je dostupné.

Příklad:

"2020123456"

vatId

string | null

IČ DPH klienta, ak je dostupné.

Příklad:

"SK2020123456"

isVatPayer

boolean

Informácia, či je klient aktuálne evidovaný ako platca DPH.

Příklad:

true

string | null

Kontaktný e-mail klienta.

Příklad:

"billing@acme.test"

street

string | null

Ulica a číslo fakturačnej adresy.

Příklad:

"Hlavná 1"

city

string | null

Mesto fakturačnej adresy.

Příklad:

"Bratislava"

zip

string | null

PSČ fakturačnej adresy.

Příklad:

"81101"

country

object | null

Fakturačná krajina klienta ako vnorený objekt.

Show child attributes

hasDeliveryAddress

boolean

Informácia, či má klient uloženú samostatnú dodaciu adresu odlišnú od fakturačnej adresy.

Příklad:

true

deliveryStreet

string | null

Ulica a číslo dodacej adresy.

Příklad:

"Skladová 9"

deliveryCity

string | null

Mesto dodacej adresy.

Příklad:

"Košice"

deliveryZip

string | null

PSČ dodacej adresy.

Příklad:

"04001"

deliveryCountry

object | null

Dodacia krajina klienta ako vnorený objekt.

Show child attributes

createdAt

string<date-time> | null

Dátum a čas vytvorenia klienta.

Příklad:

"2026-03-03T12:00:00+01:00"

updatedAt

string<date-time> | null

Dátum a čas poslednej úpravy klienta.

Příklad:

"2026-03-03T15:45:00+01:00"

preferredDeliveryMethodId

integer | null

Predvolená hodnota spôsobu dodania pre klienta. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z referenčnej tabuľky spôsobov dodania.

Příklad:

1

preferredPaymentMethodId

integer | null

Predvolená hodnota spôsobu úhrady pre klienta. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z referenčnej tabuľky spôsobov úhrady.

Příklad:

1

preferredCurrencyId

integer | null

Predvolená hodnota meny pre klienta. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z referenčnej tabuľky mien.

Příklad:

1

preferredLanguageId

integer | null

Predvolená hodnota jazyka pre klienta. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade. Hodnota pochádza z referenčnej tabuľky jazykov.

Příklad:

1

preferredDueDays

integer | null

Predvolený počet dní splatnosti. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.

Příklad:

14

preferredNote

string | null

Predvolená poznámka. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.

Příklad:

"Splatnosť 14 dní."

preferredVariableSymbol

integer | null

Predvolený variabilný symbol. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.

Příklad:

2026001

preferredConstantSymbol

integer | null

Predvolený konštantný symbol. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.

Příklad:

308

preferredSpecificSymbol

integer | null

Predvolený špecifický symbol. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.

Příklad:

55

preferredTextAboveItems

string | null

Predvolený text nad položkami. Ukladá sa pri klientovi a používa sa ako fallback default pri tvorbe nových dokladov pre tohto klienta, ak explicitnú hodnotu nepošlete v payloade.

Příklad:

"Dakujeme za spoluprácu."

Vytvoriť klienta

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/clients \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme s.r.o.",
  "type": "company",
  "subjectId": "12345678",
  "taxId": "2020123456",
  "vatId": "SK2020123456",
  "isVatPayer": true,
  "email": "billing@acme.test",
  "street": "Hlavná 1",
  "city": "Bratislava",
  "zip": "81101",
  "countryId": 703,
  "deliveryStreet": "Skladová 9",
  "deliveryCity": "Košice",
  "deliveryZip": "04001",
  "deliveryCountryId": 703,
  "preferredDeliveryMethodId": 1,
  "preferredPaymentMethodId": 1,
  "preferredCurrencyId": 1,
  "preferredLanguageId": 1,
  "preferredDueDays": 14,
  "preferredNote": "Splatnosť 14 dní.",
  "stripeCustomerId": "cus_public_api_123",
  "systemeioContactId": 123456,
  "preferredVariableSymbol": 2026001,
  "preferredConstantSymbol": 308,
  "preferredSpecificSymbol": 55,
  "preferredTextAboveItems": "Dakujeme za spoluprácu."
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/clients"

payload = {
    "name": "Acme s.r.o.",
    "type": "company",
    "subjectId": "12345678",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "isVatPayer": True,
    "email": "billing@acme.test",
    "street": "Hlavná 1",
    "city": "Bratislava",
    "zip": "81101",
    "countryId": 703,
    "deliveryStreet": "Skladová 9",
    "deliveryCity": "Košice",
    "deliveryZip": "04001",
    "deliveryCountryId": 703,
    "preferredDeliveryMethodId": 1,
    "preferredPaymentMethodId": 1,
    "preferredCurrencyId": 1,
    "preferredLanguageId": 1,
    "preferredDueDays": 14,
    "preferredNote": "Splatnosť 14 dní.",
    "stripeCustomerId": "cus_public_api_123",
    "systemeioContactId": 123456,
    "preferredVariableSymbol": 2026001,
    "preferredConstantSymbol": 308,
    "preferredSpecificSymbol": 55,
    "preferredTextAboveItems": "Dakujeme za spoluprácu."
}
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: 'Acme s.r.o.',
    type: 'company',
    subjectId: '12345678',
    taxId: '2020123456',
    vatId: 'SK2020123456',
    isVatPayer: true,
    email: 'billing@acme.test',
    street: 'Hlavná 1',
    city: 'Bratislava',
    zip: '81101',
    countryId: 703,
    deliveryStreet: 'Skladová 9',
    deliveryCity: 'Košice',
    deliveryZip: '04001',
    deliveryCountryId: 703,
    preferredDeliveryMethodId: 1,
    preferredPaymentMethodId: 1,
    preferredCurrencyId: 1,
    preferredLanguageId: 1,
    preferredDueDays: 14,
    preferredNote: 'Splatnosť 14 dní.',
    stripeCustomerId: 'cus_public_api_123',
    systemeioContactId: 123456,
    preferredVariableSymbol: 2026001,
    preferredConstantSymbol: 308,
    preferredSpecificSymbol: 55,
    preferredTextAboveItems: 'Dakujeme za spoluprácu.'
  })
};

fetch('https://app.fintoro.sk/api/public/v1/clients', 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/clients",
  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' => 'Acme s.r.o.',
    'type' => 'company',
    'subjectId' => '12345678',
    'taxId' => '2020123456',
    'vatId' => 'SK2020123456',
    'isVatPayer' => true,
    'email' => 'billing@acme.test',
    'street' => 'Hlavná 1',
    'city' => 'Bratislava',
    'zip' => '81101',
    'countryId' => 703,
    'deliveryStreet' => 'Skladová 9',
    'deliveryCity' => 'Košice',
    'deliveryZip' => '04001',
    'deliveryCountryId' => 703,
    'preferredDeliveryMethodId' => 1,
    'preferredPaymentMethodId' => 1,
    'preferredCurrencyId' => 1,
    'preferredLanguageId' => 1,
    'preferredDueDays' => 14,
    'preferredNote' => 'Splatnosť 14 dní.',
    'stripeCustomerId' => 'cus_public_api_123',
    'systemeioContactId' => 123456,
    'preferredVariableSymbol' => 2026001,
    'preferredConstantSymbol' => 308,
    'preferredSpecificSymbol' => 55,
    'preferredTextAboveItems' => 'Dakujeme za spoluprácu.'
  ]),
  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/clients"

	payload := strings.NewReader("{\n  \"name\": \"Acme s.r.o.\",\n  \"type\": \"company\",\n  \"subjectId\": \"12345678\",\n  \"taxId\": \"2020123456\",\n  \"vatId\": \"SK2020123456\",\n  \"isVatPayer\": true,\n  \"email\": \"billing@acme.test\",\n  \"street\": \"Hlavná 1\",\n  \"city\": \"Bratislava\",\n  \"zip\": \"81101\",\n  \"countryId\": 703,\n  \"deliveryStreet\": \"Skladová 9\",\n  \"deliveryCity\": \"Košice\",\n  \"deliveryZip\": \"04001\",\n  \"deliveryCountryId\": 703,\n  \"preferredDeliveryMethodId\": 1,\n  \"preferredPaymentMethodId\": 1,\n  \"preferredCurrencyId\": 1,\n  \"preferredLanguageId\": 1,\n  \"preferredDueDays\": 14,\n  \"preferredNote\": \"Splatnosť 14 dní.\",\n  \"stripeCustomerId\": \"cus_public_api_123\",\n  \"systemeioContactId\": 123456,\n  \"preferredVariableSymbol\": 2026001,\n  \"preferredConstantSymbol\": 308,\n  \"preferredSpecificSymbol\": 55,\n  \"preferredTextAboveItems\": \"Dakujeme za spoluprácu.\"\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/clients")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Acme s.r.o.\",\n  \"type\": \"company\",\n  \"subjectId\": \"12345678\",\n  \"taxId\": \"2020123456\",\n  \"vatId\": \"SK2020123456\",\n  \"isVatPayer\": true,\n  \"email\": \"billing@acme.test\",\n  \"street\": \"Hlavná 1\",\n  \"city\": \"Bratislava\",\n  \"zip\": \"81101\",\n  \"countryId\": 703,\n  \"deliveryStreet\": \"Skladová 9\",\n  \"deliveryCity\": \"Košice\",\n  \"deliveryZip\": \"04001\",\n  \"deliveryCountryId\": 703,\n  \"preferredDeliveryMethodId\": 1,\n  \"preferredPaymentMethodId\": 1,\n  \"preferredCurrencyId\": 1,\n  \"preferredLanguageId\": 1,\n  \"preferredDueDays\": 14,\n  \"preferredNote\": \"Splatnosť 14 dní.\",\n  \"stripeCustomerId\": \"cus_public_api_123\",\n  \"systemeioContactId\": 123456,\n  \"preferredVariableSymbol\": 2026001,\n  \"preferredConstantSymbol\": 308,\n  \"preferredSpecificSymbol\": 55,\n  \"preferredTextAboveItems\": \"Dakujeme za spoluprácu.\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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\": \"Acme s.r.o.\",\n  \"type\": \"company\",\n  \"subjectId\": \"12345678\",\n  \"taxId\": \"2020123456\",\n  \"vatId\": \"SK2020123456\",\n  \"isVatPayer\": true,\n  \"email\": \"billing@acme.test\",\n  \"street\": \"Hlavná 1\",\n  \"city\": \"Bratislava\",\n  \"zip\": \"81101\",\n  \"countryId\": 703,\n  \"deliveryStreet\": \"Skladová 9\",\n  \"deliveryCity\": \"Košice\",\n  \"deliveryZip\": \"04001\",\n  \"deliveryCountryId\": 703,\n  \"preferredDeliveryMethodId\": 1,\n  \"preferredPaymentMethodId\": 1,\n  \"preferredCurrencyId\": 1,\n  \"preferredLanguageId\": 1,\n  \"preferredDueDays\": 14,\n  \"preferredNote\": \"Splatnosť 14 dní.\",\n  \"stripeCustomerId\": \"cus_public_api_123\",\n  \"systemeioContactId\": 123456,\n  \"preferredVariableSymbol\": 2026001,\n  \"preferredConstantSymbol\": 308,\n  \"preferredSpecificSymbol\": 55,\n  \"preferredTextAboveItems\": \"Dakujeme za spoluprácu.\"\n}"

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

{
  "id": 101,
  "name": "Acme s.r.o.",
  "type": "company",
  "subjectId": "12345678",
  "taxId": "2020123456",
  "vatId": "SK2020123456",
  "isVatPayer": true,
  "email": "billing@acme.test",
  "street": "Hlavná 1",
  "city": "Bratislava",
  "zip": "81101",
  "country": {
    "id": 703,
    "name": "Slovensko",
    "code": "SK",
    "eu": true
  },
  "hasDeliveryAddress": true,
  "deliveryStreet": "Skladová 9",
  "deliveryCity": "Košice",
  "deliveryZip": "04001",
  "deliveryCountry": {
    "id": 703,
    "name": "Slovensko",
    "code": "SK",
    "eu": true
  },
  "createdAt": "2026-03-03T12:00:00+01:00",
  "updatedAt": "2026-03-03T15:45:00+01:00",
  "preferredDeliveryMethodId": 1,
  "preferredPaymentMethodId": 1,
  "preferredCurrencyId": 1,
  "preferredLanguageId": 1,
  "preferredDueDays": 14,
  "preferredNote": "Splatnosť 14 dní.",
  "preferredVariableSymbol": 2026001,
  "preferredConstantSymbol": 308,
  "preferredSpecificSymbol": 55,
  "preferredTextAboveItems": "Dakujeme za spoluprácu."
}

{
  "error": "Idempotency-Key reused with different request payload"
}

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

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Prehľad

Endpointy

Autorizace

Hlavičky

Tělo

Odpověď