Skip to main content

Webhooks

Webhooks enable you to receive real-time notifications about specific events in your Accounting application. To set up a webhook, follow the steps below:

Adding a Webhook

  1. Navigate to the Accounting software dashboard at https://dashboard.accounting.sh.
  2. In the dashboard, go to the Webhooks section.
  3. Create a new Webhook, specifying the events you want to receive an event for and a URL.

You can optionally add a signature. This signature is sent as is in the X-Webhook-Signature header.

Webhook Headers

When a webhook is triggered, the server sends the following headers:

  • X-Webhook-ID: The UUID of the webhook.
  • X-Webhook-Event: The specific event the webhook is sent for.

Make sure to use these headers to identify the webhook and the associated event.

Webhook events

EventDescription
new.accountTriggered when a new account is created.
updated.accountTriggered when an account is updated.
delete.accountTriggered when an account is deleted.
new.billTriggered when a new bill is created.
updated.billTriggered when a bill is updated.
paid.billTriggered when a bill is marked as paid.
paid.bill:updatedTriggered when the payment status of a bill is updated.
new.categoryTriggered when a new category is created.
updated.categoryTriggered when a category is updated.
deleted.categoryTriggered when a category is deleted.
company.updatedTriggered when company details are updated.
new.credentialTriggered when a new credential is created.
updated.credentialTriggered when a credential is updated.
new.contactTriggered when a new contact is created.
updated.contactTriggered when a contact is updated.
deleted.contactTriggered when a contact is deleted.
new.documentTriggered when a new document is created.
updated.documentTriggered when a document is updated.
new.invoiceTriggered when a new invoice is created.
updated.invoiceTriggered when an invoice is updated.
paid.invoiceTriggered when an invoice is marked as paid.
paid.invoice:updatedTriggered when the payment status of an invoice is updated.
due.invoiceTriggered when an invoice is due.
due_past.invoiceTriggered when an invoice becomes past due.
new.paymentTriggered when a new payment is created.
updated.paymentTriggered when a payment is updated.
deleted.paymentTriggered when a payment is deleted.
new.quoteTriggered when a new quote is created.
updated.quoteTriggered when a quote is updated.
new.receiptTriggered when a new receipt is created.
updated.receiptTriggered when a receipt is updated.
new.revenueTriggered when a new revenue entry is created.
updated.revenueTriggered when a revenue entry is updated.
updated.settingTriggered when a setting is updated.
new.tagTriggered when a new tag is created.
updated.tagTriggered when a tag is updated.
deleted.tagTriggered when a tag is deleted.
new.transferTriggered when a new transfer is created.
updated.transferTriggered when a transfer is updated.
deleted.transferTriggered when a transfer is deleted.
new.webhookTriggered when a new webhook is created.
updated.webhookTriggered when a webhook is updated.
deleted.webhookTriggered when a webhook is deleted.
new.woocommerce⚠️ DEPRECATED - Triggered when a new WooCommerce entry is created.
deleted.woocommerce⚠️ DEPRECATED - Triggered when a WooCommerce entry is deleted.
new.vatTriggered when a new VAT entry is created.
updated.vatTriggered when a VAT entry is updated.
deleted.vatTriggered when a VAT entry is deleted.
new.transactionTriggered when a new transaction is created.
updated.transactionTriggered when a transaction is updated.
deleted.transactionTriggered when a transaction is deleted.
deleted.invoiceTriggered when an invoice is deleted.
deleted.quoteTriggered when a quote is deleted.
deleted.receiptTriggered when a receipt is deleted.
deleted.revenueTriggered when a revenue entry is deleted.
new.attachmentTriggered when a new attachment is created.
updated.attachmentTriggered when an attachment is updated.
deleted.attachmentTriggered when an attachment is deleted.
new.stripe⚠️ DEPRECATED - Triggered when a new Stripe entry is created.
edit.stripe⚠️ DEPRECATED - Triggered when a Stripe entry is edited.
deleted.stripe⚠️ DEPRECATED - Triggered when a Stripe entry is deleted.
deleted.stripe:webhook⚠️ DEPRECATED - Triggered when a Stripe webhook entry is deleted.
edit.stripe:webhook⚠️ DEPRECATED - Triggered when a Stripe webhook entry is edited.
new.stripe:webhook⚠️ DEPRECATED - Triggered when a new Stripe webhook entry is created.
new.exportTriggered when a new data export is created.
edit.exportTriggered when an existing data export is edited.
deleted.exportTriggered when a data export is deleted.
new.account:connectionTriggered when a new account connection is created.
edit.account:connectionTriggered when an account connection is edited.
deleted.account:connectionTriggered when an account connection is deleted.
new.expense_reportTriggered when a new expense report is created.
edit.expense_reportTriggered when an expense report is edited.
deleted.expense_reportTriggered when an expense report is deleted.
updated.expense_reportTriggered when an expense report is updated.
new.expense_report:userTriggered when a new expense report for a user is created.
updated.expense_report:userTriggered when an expense report for a user is updated.
deleted.expense_report:userTriggered when an expense report for a user is deleted.
new.accounting_codeTriggered when a new accounting code is created.
edit.accounting_codeTriggered when an accounting code is edited.
deleted.accounting_codeTriggered when an accounting code is deleted.
new.accounting_code:transactionTriggered when a new accounting code transaction is created.
edit.accounting_code:transactionTriggered when an accounting code transaction is edited.
deleted.accounting_code:transactionTriggered when an accounting code transaction is deleted.
new.oauth_configTriggered when a new OAuth configuration is created.
edit.oauth_configTriggered when an OAuth configuration is edited.
deleted.oauth_configTriggered when an OAuth configuration is deleted.