Skip to main content
PUT
Update webhook subscription

Authorizations

Authorization
string
header
required

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

Path Parameters

webhookSubscription
integer
required

Webhook subscription ID.

Example:

801

Body

application/json

Payload used to create or update a webhook subscription. Use only an HTTPS endpoint that can accept JSON POST requests from Fintoro and whose hostname resolves to a public IP address.

url
string<uri>
required

HTTPS URL of your webhook receiver. The backend rejects insecure http:// addresses, endpoints with embedded username or password, and hosts that resolve to localhost, .local, private, loopback, link-local, or other reserved IP addresses. The same validation runs again immediately before the webhook is sent.

Maximum string length: 2048
Example:

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

isActive
boolean
required

Controls whether the subscription is active immediately after it is saved.

Example:

true

subscribedEvents
enum<string>[]
required

List of event types that Fintoro should deliver to this endpoint. The array must contain at least one event.

Minimum array length: 1

Webhook event type that you can subscribe to and that Fintoro can deliver to your endpoint.

Available options:
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:
name
string | null

Optional internal subscription name that makes the subscription easier to identify in Fintoro or inside your integration team.

Maximum string length: 255
Example:

"ERP sync"

Response

Webhook subscription updated.

One webhook subscription for the current company.

id
integer

Internal webhook subscription ID.

Example:

801

companyId
integer

ID of the company that owns the subscription.

Example:

15

name
string | null

Optional internal subscription name used for your own orientation.

Maximum string length: 255
Example:

"ERP sync"

url
string<uri>

HTTPS URL where Fintoro delivers webhook requests. The hostname must point to a public IP address; localhost, .local, private ranges, and reserved addresses are rejected by the backend.

Maximum string length: 2048
Example:

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

isActive
boolean

When true, the subscription is active and can receive delivery requests.

Example:

true

subscribedEvents
enum<string>[]

List of event types delivered for this subscription.

Webhook event type that you can subscribe to and that Fintoro can deliver to your endpoint.

Available options:
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:
lastSuccessAt
string<date-time> | null

ISO 8601 time of the last successful delivery, when one exists.

Example:

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

lastFailureAt
string<date-time> | null

ISO 8601 time of the last failed delivery, when one exists.

Example:

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

disabledAt
string<date-time> | null

ISO 8601 time when the subscription was disabled. In this API version it remains null unless you disable the subscription manually or a future version adds auto-disable flows.

Example:

null

disabledReason
string | null

Reason why the subscription was disabled, when available.

Example:

null

createdAt
string<date-time> | null

ISO 8601 time when the subscription was created.

Example:

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

updatedAt
string<date-time> | null

ISO 8601 time of the last subscription change.

Example:

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