List webhook subscriptions

GET

webhook-subscriptions

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/webhook-subscriptions \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "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"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer token created for a specific company in Integrations → API.

Response

Webhook subscription list.

data

object[]

List of webhook subscriptions for the current company.

Show child attributes

Create webhook subscriptionCreates a new webhook subscription. `plainTextSecret` is only returned once in this response, so you must store it securely. If you send `Idempotency-Key`, a repeated create request with the same key and identical payload returns the original response without creating a second subscription. Before production rollout, prepare a receiver with signature verification, deduplication by `webhook-id`, and an internal queue for the follow-up detail fetch.

List webhook subscriptions

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/webhook-subscriptions \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "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"
    }
  ]
}