Přejít na hlavní obsah
POST
/
webhook-subscriptions
Vytvoriť odber webhookov
curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/webhook-subscriptions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://example.com/webhooks/fintoro",
  "isActive": true,
  "subscribedEvents": [
    "invoices.created",
    "invoices.updated"
  ],
  "name": "ERP sync"
}
'
{
  "id": 801,
  "companyId": 15,
  "name": "ERP sync",
  "url": "https://example.com/webhooks/fintoro",
  "isActive": true,
  "subscribedEvents": [
    "invoices.created",
    "invoices.updated"
  ],
  "lastSuccessAt": "2026-03-18T15:04:05Z",
  "lastFailureAt": "2026-03-18T15:05:42Z",
  "disabledAt": null,
  "disabledReason": null,
  "createdAt": "2026-03-18T14:59:12Z",
  "updatedAt": "2026-03-18T15:01:33Z",
  "plainTextSecret": "whsec_fintoro_8b5d7c9f4f6549f7a3e8c4fd5f55ab91"
}

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 create alebo update odberu webhookov. Používajte iba HTTPS endpoint, ktorý vie prijať JSON POST requesty od Fintoro a ktorého hostname sa resolvne na verejnú IP adresu.

​
url
string<uri>
povinné

HTTPS URL prijímača webhookov. Backend odmietne nezabezpečené http:// adresy, endpointy s používateľským menom alebo heslom a hosty, ktoré sa resolvnu na localhost, .local, privátne, loopback, link-local alebo iné rezervované IP adresy. Rovnaká kontrola prebehne znovu aj tesne pred samotným odoslaním webhooku.

Maximum string length: 2048
Příklad:

"https://example.com/webhooks/fintoro"

​
isActive
boolean
povinné

Určuje, či je subscription aktívny hneď po uložení.

Příklad:

true

​
subscribedEvents
enum<string>[]
povinné

Zoznam event typov, ktoré má Fintoro na tento endpoint posielať. Pole musí obsahovať aspoň jednu udalosť.

Minimum array length: 1

Typ webhook udalosti, ktorú môžete subscribnuť a ktorú Fintoro následne doručuje na Váš endpoint.

Dostupné možnosti:
clients.created,
clients.updated,
clients.deleted,
suppliers.created,
suppliers.updated,
suppliers.deleted,
bank-accounts.created,
bank-accounts.updated,
bank-accounts.deleted,
business-case-statuses.created,
business-case-statuses.updated,
business-case-statuses.deleted,
business-cases.created,
business-cases.updated,
business-cases.deleted,
contact-activity-logs.created,
contact-activity-logs.updated,
contact-activity-logs.deleted,
price-list-items.created,
price-list-items.updated,
price-list-items.deleted,
price-list-items.stock-updated,
warehouses.created,
warehouses.updated,
warehouses.deleted,
warehouse-inbound-receipts.created,
warehouse-inbound-receipts.updated,
warehouse-inbound-receipts.deleted,
warehouse-outbound-receipts.created,
warehouse-outbound-receipts.updated,
warehouse-outbound-receipts.deleted,
invoices.created,
invoices.updated,
invoices.deleted,
invoices.paid,
credit-notes.created,
credit-notes.updated,
credit-notes.deleted,
credit-notes.paid,
received-invoices.paid,
received-receipts.paid,
proformas.created,
proformas.updated,
proformas.deleted,
proformas.paid,
orders.created,
orders.updated,
orders.deleted,
quotations.created,
quotations.updated,
quotations.deleted,
document-payments.created,
document-payments.deleted
Příklad:
["invoices.created", "invoices.updated"]
​
name
string | null

Voliteľný interný názov subscription pre Vašu orientáciu vo Fintoro alebo v integračnom tíme.

Maximum string length: 255
Příklad:

"ERP sync"

Odpověď

Odber webhookov bol vytvorený.

Jeden odber webhookov aktuálnej firmy.

​
id
integer

Interné ID odberu webhookov.

Příklad:

801

​
companyId
integer

ID firmy, ku ktorej subscription patrí.

Příklad:

15

​
name
string | null

Voliteľný interný názov subscription pre Vašu orientáciu.

Maximum string length: 255
Příklad:

"ERP sync"

​
url
string<uri>

HTTPS URL, na ktorú Fintoro doručuje webhook requesty. Hostname musí smerovať na verejnú IP adresu; localhost, .local, privátne rozsahy a rezervované adresy backend odmietne.

Maximum string length: 2048
Příklad:

"https://example.com/webhooks/fintoro"

​
isActive
boolean

Ak je true, subscription je aktívny a môže prijímať delivery requesty.

Příklad:

true

​
subscribedEvents
enum<string>[]

Zoznam event typov, ktoré sa majú pre tento subscription doručovať.

Typ webhook udalosti, ktorú môžete subscribnuť a ktorú Fintoro následne doručuje na Váš endpoint.

Dostupné možnosti:
clients.created,
clients.updated,
clients.deleted,
suppliers.created,
suppliers.updated,
suppliers.deleted,
bank-accounts.created,
bank-accounts.updated,
bank-accounts.deleted,
business-case-statuses.created,
business-case-statuses.updated,
business-case-statuses.deleted,
business-cases.created,
business-cases.updated,
business-cases.deleted,
contact-activity-logs.created,
contact-activity-logs.updated,
contact-activity-logs.deleted,
price-list-items.created,
price-list-items.updated,
price-list-items.deleted,
price-list-items.stock-updated,
warehouses.created,
warehouses.updated,
warehouses.deleted,
warehouse-inbound-receipts.created,
warehouse-inbound-receipts.updated,
warehouse-inbound-receipts.deleted,
warehouse-outbound-receipts.created,
warehouse-outbound-receipts.updated,
warehouse-outbound-receipts.deleted,
invoices.created,
invoices.updated,
invoices.deleted,
invoices.paid,
credit-notes.created,
credit-notes.updated,
credit-notes.deleted,
credit-notes.paid,
received-invoices.paid,
received-receipts.paid,
proformas.created,
proformas.updated,
proformas.deleted,
proformas.paid,
orders.created,
orders.updated,
orders.deleted,
quotations.created,
quotations.updated,
quotations.deleted,
document-payments.created,
document-payments.deleted
Příklad:
["invoices.created", "invoices.updated"]
​
lastSuccessAt
string<date-time> | null

ISO 8601 čas posledného úspešného doručenia, ak už k nemu došlo.

Příklad:

"2026-03-18T15:04:05Z"

​
lastFailureAt
string<date-time> | null

ISO 8601 čas posledného neúspešného doručenia, ak už k nemu došlo.

Příklad:

"2026-03-18T15:05:42Z"

​
disabledAt
string<date-time> | null

ISO 8601 čas deaktivácie subscription. V tejto verzii ostáva null, pokiaľ subscription manuálne nevypnete alebo budúce verzie nepridajú auto-disable flow.

Příklad:

null

​
disabledReason
string | null

Dôvod deaktivácie subscription, ak je známy.

Příklad:

null

​
createdAt
string<date-time> | null

ISO 8601 čas vytvorenia subscription.

Příklad:

"2026-03-18T14:59:12Z"

​
updatedAt
string<date-time> | null

ISO 8601 čas poslednej zmeny subscription.

Příklad:

"2026-03-18T15:01:33Z"

​
plainTextSecret
string

Secret na podpisovanie zobrazený iba pri create alebo rotate-secret flowe v otvorenej podobe. Bezpečne si ho uložte; v ďalších odpovediach sa už nevracia.

Příklad:

"whsec_fintoro_8b5d7c9f4f6549f7a3e8c4fd5f55ab91"