Skip to main content
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
}
'
{
  "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
  }
}

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

​
email
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.

​
id
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

​
email
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

Supplier country as a nested object.