Create supplier

POST

suppliers

Create supplier

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/suppliers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Supplier s.r.o.",
  "type": "company",
  "subjectId": "12345678",
  "taxId": "2020123456",
  "vatId": "SK2020123456",
  "isVatPayer": true,
  "email": "billing@supplier.test",
  "street": "Supplier Street 1",
  "city": "Bratislava",
  "zip": "81101",
  "countryId": 703
}
'

import requests

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

payload = {
    "name": "Supplier s.r.o.",
    "type": "company",
    "subjectId": "12345678",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "isVatPayer": True,
    "email": "billing@supplier.test",
    "street": "Supplier Street 1",
    "city": "Bratislava",
    "zip": "81101",
    "countryId": 703
}
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: 'Supplier s.r.o.',
    type: 'company',
    subjectId: '12345678',
    taxId: '2020123456',
    vatId: 'SK2020123456',
    isVatPayer: true,
    email: 'billing@supplier.test',
    street: 'Supplier Street 1',
    city: 'Bratislava',
    zip: '81101',
    countryId: 703
  })
};

fetch('https://app.fintoro.sk/api/public/v1/suppliers', 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/suppliers",
  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' => 'Supplier s.r.o.',
    'type' => 'company',
    'subjectId' => '12345678',
    'taxId' => '2020123456',
    'vatId' => 'SK2020123456',
    'isVatPayer' => true,
    'email' => 'billing@supplier.test',
    'street' => 'Supplier Street 1',
    'city' => 'Bratislava',
    'zip' => '81101',
    'countryId' => 703
  ]),
  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/suppliers"

	payload := strings.NewReader("{\n  \"name\": \"Supplier s.r.o.\",\n  \"type\": \"company\",\n  \"subjectId\": \"12345678\",\n  \"taxId\": \"2020123456\",\n  \"vatId\": \"SK2020123456\",\n  \"isVatPayer\": true,\n  \"email\": \"billing@supplier.test\",\n  \"street\": \"Supplier Street 1\",\n  \"city\": \"Bratislava\",\n  \"zip\": \"81101\",\n  \"countryId\": 703\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/suppliers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Supplier s.r.o.\",\n  \"type\": \"company\",\n  \"subjectId\": \"12345678\",\n  \"taxId\": \"2020123456\",\n  \"vatId\": \"SK2020123456\",\n  \"isVatPayer\": true,\n  \"email\": \"billing@supplier.test\",\n  \"street\": \"Supplier Street 1\",\n  \"city\": \"Bratislava\",\n  \"zip\": \"81101\",\n  \"countryId\": 703\n}")
  .asString();

require 'uri'
require 'net/http'

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

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\": \"Supplier s.r.o.\",\n  \"type\": \"company\",\n  \"subjectId\": \"12345678\",\n  \"taxId\": \"2020123456\",\n  \"vatId\": \"SK2020123456\",\n  \"isVatPayer\": true,\n  \"email\": \"billing@supplier.test\",\n  \"street\": \"Supplier Street 1\",\n  \"city\": \"Bratislava\",\n  \"zip\": \"81101\",\n  \"countryId\": 703\n}"

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

{
  "id": 151,
  "type": "company",
  "name": "Supplier s.r.o.",
  "subjectId": "12345678",
  "taxId": "2020202020",
  "vatId": "SK2020202020",
  "isVatPayer": true,
  "email": "billing@supplier.test",
  "street": "Supplier Street 1",
  "city": "Bratislava",
  "zip": "81101",
  "country": {
    "id": 703,
    "name": "Slovakia",
    "code": "SK",
    "eu": true
  }
}

{
  "message": "The given data was invalid.",
  "error": "Idempotency-Key reused with different request payload",
  "errors": {}
}

{
  "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.

Headers

Idempotency-Key

string

Optional request identifier for safe retries. Use a unique value for each create request you want to retry safely.

Example:

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

Body

application/json

Payload for creating a supplier. If you omit type, the backend infers it from subjectId, taxId, and vatId. If you omit isVatPayer, the backend infers it from vatId.

name

string

required

Supplier trade name or personal name.

Maximum string length: 255

Example:

"Supplier s.r.o."

type

enum<string>

Supplier type. If omitted, the backend infers it from identifier fields.

Available options:

person,

company

Example:

"company"

subjectId

string | null

Supplier business ID when available.

Maximum string length: 40

Example:

"12345678"

taxId

string | null

Supplier tax ID when available.

Maximum string length: 40

Example:

"2020123456"

vatId

string | null

Supplier VAT ID when available.

Maximum string length: 40

Example:

"SK2020123456"

isVatPayer

boolean

Whether the supplier is a VAT payer. If omitted, the backend infers it from vatId.

Example:

true

string<email> | null

Supplier contact email.

Maximum string length: 255

Example:

"billing@supplier.test"

street

string | null

Supplier billing street and number.

Maximum string length: 255

Example:

"Supplier Street 1"

city

string | null

Supplier billing city.

Maximum string length: 255

Example:

"Bratislava"

zip

string | null

Supplier ZIP or postal code.

Maximum string length: 10

Example:

"81101"

countryId

integer | null

Billing country ID from the country reference table.

Example:

703

Response

Supplier created.

Supplier in the exact shape returned as a nested object on a business case.

integer

Internal supplier ID in Fintoro.

Example:

151

type

string

Supplier type.

Example:

"company"

name

string

Company name or personal name of the supplier.

Example:

"Supplier s.r.o."

subjectId

string | null

Supplier business ID when available.

Example:

"12345678"

taxId

string | null

Supplier tax ID when available.

Example:

"2020202020"

vatId

string | null

Supplier VAT ID when available.

Example:

"SK2020202020"

isVatPayer

boolean

Indicates whether the supplier is currently marked as a VAT payer.

Example:

true

string | null

Supplier contact email.

Example:

"billing@supplier.test"

street

string | null

Supplier street and house number.

Example:

"Supplier Street 1"

city

string | null

Supplier city.

Example:

"Bratislava"

zip

string | null

Supplier ZIP code.

Example:

"81101"

country

object | null

Supplier country as a nested object.

Show child attributes

Create supplier

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/suppliers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Supplier s.r.o.",
  "type": "company",
  "subjectId": "12345678",
  "taxId": "2020123456",
  "vatId": "SK2020123456",
  "isVatPayer": true,
  "email": "billing@supplier.test",
  "street": "Supplier Street 1",
  "city": "Bratislava",
  "zip": "81101",
  "countryId": 703
}
'

import requests

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

payload = {
    "name": "Supplier s.r.o.",
    "type": "company",
    "subjectId": "12345678",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "isVatPayer": True,
    "email": "billing@supplier.test",
    "street": "Supplier Street 1",
    "city": "Bratislava",
    "zip": "81101",
    "countryId": 703
}
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: 'Supplier s.r.o.',
    type: 'company',
    subjectId: '12345678',
    taxId: '2020123456',
    vatId: 'SK2020123456',
    isVatPayer: true,
    email: 'billing@supplier.test',
    street: 'Supplier Street 1',
    city: 'Bratislava',
    zip: '81101',
    countryId: 703
  })
};

fetch('https://app.fintoro.sk/api/public/v1/suppliers', 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/suppliers",
  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' => 'Supplier s.r.o.',
    'type' => 'company',
    'subjectId' => '12345678',
    'taxId' => '2020123456',
    'vatId' => 'SK2020123456',
    'isVatPayer' => true,
    'email' => 'billing@supplier.test',
    'street' => 'Supplier Street 1',
    'city' => 'Bratislava',
    'zip' => '81101',
    'countryId' => 703
  ]),
  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/suppliers"

	payload := strings.NewReader("{\n  \"name\": \"Supplier s.r.o.\",\n  \"type\": \"company\",\n  \"subjectId\": \"12345678\",\n  \"taxId\": \"2020123456\",\n  \"vatId\": \"SK2020123456\",\n  \"isVatPayer\": true,\n  \"email\": \"billing@supplier.test\",\n  \"street\": \"Supplier Street 1\",\n  \"city\": \"Bratislava\",\n  \"zip\": \"81101\",\n  \"countryId\": 703\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/suppliers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Supplier s.r.o.\",\n  \"type\": \"company\",\n  \"subjectId\": \"12345678\",\n  \"taxId\": \"2020123456\",\n  \"vatId\": \"SK2020123456\",\n  \"isVatPayer\": true,\n  \"email\": \"billing@supplier.test\",\n  \"street\": \"Supplier Street 1\",\n  \"city\": \"Bratislava\",\n  \"zip\": \"81101\",\n  \"countryId\": 703\n}")
  .asString();

require 'uri'
require 'net/http'

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

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\": \"Supplier s.r.o.\",\n  \"type\": \"company\",\n  \"subjectId\": \"12345678\",\n  \"taxId\": \"2020123456\",\n  \"vatId\": \"SK2020123456\",\n  \"isVatPayer\": true,\n  \"email\": \"billing@supplier.test\",\n  \"street\": \"Supplier Street 1\",\n  \"city\": \"Bratislava\",\n  \"zip\": \"81101\",\n  \"countryId\": 703\n}"

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

{
  "id": 151,
  "type": "company",
  "name": "Supplier s.r.o.",
  "subjectId": "12345678",
  "taxId": "2020202020",
  "vatId": "SK2020202020",
  "isVatPayer": true,
  "email": "billing@supplier.test",
  "street": "Supplier Street 1",
  "city": "Bratislava",
  "zip": "81101",
  "country": {
    "id": 703,
    "name": "Slovakia",
    "code": "SK",
    "eu": true
  }
}

{
  "message": "The given data was invalid.",
  "error": "Idempotency-Key reused with different request payload",
  "errors": {}
}

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

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Overview

Endpoints

Authorizations

Headers

Body

Response