Event catalogue

A webhook’s type field selects which Quiddly events it receives. Subscribe to one event type per webhook - the same URL can be reused across multiple subscriptions.

type	When it fires
INVOICE	An invoice was created or its status changed.
INVOICE_CREATED	A new invoice was created (subset of INVOICE, useful when you only care about origination).
INVOICE_BALANCE	The outstanding balance on an invoice changed (payment matched, write-off, etc.).
INVOICE_REFINANCE	An invoice was refinanced (factoring lifecycle).
FACTORING_STATUS	A factoring agreement transitioned state.
DISTRIBUTION	A document was distributed (email, post, e-invoice channel).
PAYOUT_FILE_XML	A SEPA/payouts XML file was generated and is ready for download.
PAYOUT_FILE_TXT	Same as above for the legacy plaintext format.
BOOKKEEPING_FILE_SIE	A Swedish SIE bookkeeping file is ready.
VOUCHER	A bookkeeping voucher was finalized.
VOUCHER_PAYMENT	A payment voucher was generated.
SYSTEM_DEBTOR	A system-debtor record was created or updated.
CREDIT_CHECK	A credit-check result is available.
TRANSACTION_MONITORING	AML transaction-monitoring flagged a transaction.
BUSINESS_LOAN_CREATED	A business loan was created.
BUSINESS_LOAN_MAIN_STATUS	A business loan main status changed.
BUSINESS_LOAN_BALANCE	The outstanding balance on a loan changed (payment matched, write-off, etc.).
BUSINESS_LOAN_CREDIT_DECISION_STATUS	A business loan credit decision status changed.

The valid values are enforced by the WebhookTypes enum in the API and returned in the 400 response if you send an unknown one.

Payload

Each delivery POSTs the resource snapshot Quiddly captured at trigger time as JSON in the request body. The shape is the same as the resource’s GET response - see the reference for the type that matches your subscription. The delivery is identified by the X-Webhook-Id header, not by a field in the body.