> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoro.sk/llms.txt
> Use this file to discover all available pages before exploring further.

# Upraviť odber webhookov

> Pošlite úplnú konfiguráciu odberu. Zmena `url` ani `subscribedEvents` secret nemení a nespúšťa spätné doručenie historických udalostí.



## OpenAPI

````yaml /openapi.yaml put /webhook-subscriptions/{webhookSubscription}
openapi: 3.1.0
info:
  title: Fintoro API v1
  version: 1.0.0
  description: >-
    REST API na vystavovanie faktúr a ďalších dokladov, správu kontaktov, CRM a
    skladov.


    API token určuje firmu, ku ktorej máte prístup. Vytvorenie tokenu a prvé
    volanie popisuje [Prvé pripojenie](/getting-started).
servers:
  - url: https://app.fintoro.sk/api/public/v1
    description: Spoločná URL pre produkčné aj sandboxové firmy.
security:
  - bearerAuth: []
tags:
  - name: Identita tokenu
    description: Overenie firmy priradenej k API tokenu.
  - name: Lookupy
    description: Číselníky so stabilnými ID.
  - name: Číselné rady
    description: Číslovanie dokladov a variabilné symboly.
  - name: Subjekty
    description: Vyhľadávanie firiem a živnostníkov v referenčnom registri.
  - name: Klienti
    description: Klienti, adresy a predvolené hodnoty pre nové doklady.
  - name: Dodávatelia
    description: Dodávatelia a ich identifikačné a fakturačné údaje.
  - name: Stavy obchodných prípadov
    description: Stavy obchodných prípadov zodpovedajú stĺpcom obchodného procesu.
  - name: Obchodné prípady
    description: Obchodné prípady priradené klientovi alebo dodávateľovi.
  - name: CRM udalosti
    description: Poznámky, e-maily, telefonáty, odkazy na doklady a prílohy.
  - name: Bankové účty
    description: Bankové účty a údaje o existujúcom open banking napojení.
  - name: Webhooky
    description: >-
      Odbery udalostí a rotácia secretu. Doručovanie a overenie podpisu popisuje
      [príručka webhookov](/webhooks).
  - name: Sklady
    description: Sklady a číselné rady príjemiek a výdajok.
  - name: Skladové príjemky
    description: Príjem tovaru na sklad.
  - name: Skladové výdajky
    description: Výdaj tovaru zo skladu.
  - name: Skladové a cenníkové položky
    description: Cenník a položky s evidenciou skladového stavu.
  - name: Úhrady dokladov
    description: >-
      Úhrady vystavených a prijatých dokladov. Podporované typy sa líšia podľa
      operácie.
  - name: Dokladové e-maily
    description: Odosielanie dokladov e-mailom.
  - name: Faktúry
    description: Vystavovanie a správa faktúr.
  - name: Dobropisy
    description: Dobropisy naviazané na pôvodnú faktúru.
  - name: Zálohové faktúry
    description: Vystavovanie a správa zálohových faktúr.
  - name: Objednávky
    description: Vystavovanie a správa objednávok.
  - name: Cenové ponuky
    description: Vystavovanie a správa cenových ponúk.
paths:
  /webhook-subscriptions/{webhookSubscription}:
    parameters:
      - $ref: '#/components/parameters/WebhookSubscriptionId'
    put:
      tags:
        - Webhooky
      summary: Upraviť odber webhookov
      description: >-
        Pošlite úplnú konfiguráciu odberu. Zmena `url` ani `subscribedEvents`
        secret nemení a nespúšťa spätné doručenie historických udalostí.
      operationId: updateWebhookSubscription
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WebhookSubscriptionInput'
      responses:
        '200':
          description: Odber webhookov bol aktualizovaný.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/XRequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookSubscription'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/ValidationError'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
components:
  parameters:
    WebhookSubscriptionId:
      name: webhookSubscription
      in: path
      required: true
      description: ID odberu webhookov.
      schema:
        type: integer
        example: 801
  schemas:
    WebhookSubscriptionInput:
      description: Konfigurácia odberu pri vytvorení alebo úprave.
      type: object
      required:
        - url
        - isActive
        - subscribedEvents
      properties:
        name:
          description: Voliteľný názov odberu.
          type:
            - string
            - 'null'
          maxLength: 255
          example: ERP sync
        url:
          description: >-
            Verejná HTTPS URL bez prihlasovacích údajov. `localhost`, `.local` a
            privátne či rezervované IP adresy sú zakázané. Overuje sa pri
            uložení aj pred odoslaním.
          type: string
          format: uri
          maxLength: 2048
          example: https://example.com/webhooks/fintoro
        isActive:
          description: Či má odber prijímať nové udalosti.
          type: boolean
          example: true
        subscribedEvents:
          description: Udalosti doručované na URL odberu.
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/WebhookEventType'
          example:
            - invoices.created
            - invoices.updated
    WebhookSubscription:
      description: Jeden odber webhookov aktuálnej firmy.
      type: object
      properties:
        id:
          description: Interné ID odberu webhookov.
          type: integer
          example: 801
        companyId:
          description: ID firmy odberu.
          type: integer
          example: 15
        name:
          description: Voliteľný názov odberu.
          type:
            - string
            - 'null'
          maxLength: 255
          example: ERP sync
        url:
          description: HTTPS URL prijímača na verejnej IP adrese.
          type: string
          format: uri
          maxLength: 2048
          example: https://example.com/webhooks/fintoro
        isActive:
          description: Určuje, či sa pre odber vytvárajú nové doručenia.
          type: boolean
          example: true
        subscribedEvents:
          description: Udalosti doručované na URL odberu.
          type: array
          items:
            $ref: '#/components/schemas/WebhookEventType'
          example:
            - invoices.created
            - invoices.updated
        lastSuccessAt:
          description: ISO 8601 čas posledného úspešného doručenia, ak už k nemu došlo.
          type:
            - string
            - 'null'
          format: date-time
          example: '2026-03-18T15:04:05Z'
        lastFailureAt:
          description: ISO 8601 čas posledného neúspešného doručenia, ak už k nemu došlo.
          type:
            - string
            - 'null'
          format: date-time
          example: '2026-03-18T15:05:42Z'
        disabledAt:
          description: Rezervované pole; v tejto verzii zostáva `null`.
          type:
            - string
            - 'null'
          format: date-time
          example: null
        disabledReason:
          description: Dôvod deaktivácie, ak je uložený.
          type:
            - string
            - 'null'
          example: null
        createdAt:
          description: Čas vytvorenia odberu v ISO 8601.
          type:
            - string
            - 'null'
          format: date-time
          example: '2026-03-18T14:59:12Z'
        updatedAt:
          description: Čas poslednej zmeny odberu v ISO 8601.
          type:
            - string
            - 'null'
          format: date-time
          example: '2026-03-18T15:01:33Z'
    WebhookEventType:
      description: >-
        Názov udalosti v odbere aj v doručenom webhooku. [Prehľad
        udalostí](/webhook-events).
      type: string
      enum:
        - 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
      example: invoices.updated
  headers:
    XRequestId:
      description: Identifikátor požiadavky pre diagnostiku a podporu.
      schema:
        type: string
        example: req_public_api_01
    ContentLanguage:
      description: Jazyk vybraný podľa `Accept-Language`.
      schema:
        type: string
        example: en
  responses:
    Forbidden:
      description: Token alebo firma nemá oprávnenie na operáciu.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        Content-Language:
          $ref: '#/components/headers/ContentLanguage'
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: This action is unauthorized.
    NotFound:
      description: Požadovaný zdroj sa nenašiel.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        Content-Language:
          $ref: '#/components/headers/ContentLanguage'
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: No query results for model.
    ValidationError:
      description: Neplatné telo požiadavky alebo parametre URL.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        Content-Language:
          $ref: '#/components/headers/ContentLanguage'
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: The given data was invalid.
              errors:
                type: object
                additionalProperties:
                  type: array
                  items:
                    type: string
    TooManyRequests:
      description: >-
        Prekročený limit požiadaviek firmy. Pred ďalším pokusom počkajte podľa
        `Retry-After`. [Limity a opakovanie
        požiadaviek](/errors-and-idempotency).
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        X-RateLimit-Limit:
          description: >-
            Limit požiadaviek firmy v aktuálnom 60-sekundovom okne. Vracia sa aj
            pri úspešných požiadavkách.
          schema:
            type: integer
            example: 120
        X-RateLimit-Remaining:
          description: >-
            Zostávajúci počet požiadaviek v aktuálnom okne. Vracia sa aj pri
            úspešných požiadavkách.
          schema:
            type: integer
            example: 0
        Retry-After:
          description: Počet sekúnd do ďalšieho pokusu. Vracia sa pri `429`.
          schema:
            type: integer
            example: 60
        X-RateLimit-Reset:
          description: Čas obnovenia limitu ako Unix timestamp. Vracia sa pri `429`.
          schema:
            type: integer
            example: 1774810800
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Too Many Attempts.
    InternalServerError:
      description: Interná chyba.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        Content-Language:
          $ref: '#/components/headers/ContentLanguage'
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Server Error
    ServiceUnavailable:
      description: Služba je dočasne nedostupná.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/XRequestId'
        Content-Language:
          $ref: '#/components/headers/ContentLanguage'
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Service Unavailable
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Token
      description: >-
        API token firmy vytvorený vo Fintoro v Automatizácie → Fintoro API.
        [Správa tokenov](/authentication).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.