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
- Navigate to the Accounting software dashboard at https://dashboard.accounting.sh.
- In the dashboard, go to the Webhooks section.
- 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
Event | Description |
---|---|
new.account | Triggered when a new account is created. |
updated.account | Triggered when an account is updated. |
delete.account | Triggered when an account is deleted. |
new.bill | Triggered when a new bill is created. |
updated.bill | Triggered when a bill is updated. |
paid.bill | Triggered when a bill is marked as paid. |
paid.bill:updated | Triggered when the payment status of a bill is updated. |
new.category | Triggered when a new category is created. |
updated.category | Triggered when a category is updated. |
deleted.category | Triggered when a category is deleted. |
company.updated | Triggered when company details are updated. |
new.credential | Triggered when a new credential is created. |
updated.credential | Triggered when a credential is updated. |
new.contact | Triggered when a new contact is created. |
updated.contact | Triggered when a contact is updated. |
deleted.contact | Triggered when a contact is deleted. |
new.document | Triggered when a new document is created. |
updated.document | Triggered when a document is updated. |
new.invoice | Triggered when a new invoice is created. |
updated.invoice | Triggered when an invoice is updated. |
paid.invoice | Triggered when an invoice is marked as paid. |
paid.invoice:updated | Triggered when the payment status of an invoice is updated. |
due.invoice | Triggered when an invoice is due. |
due_past.invoice | Triggered when an invoice becomes past due. |
new.payment | Triggered when a new payment is created. |
updated.payment | Triggered when a payment is updated. |
deleted.payment | Triggered when a payment is deleted. |
new.quote | Triggered when a new quote is created. |
updated.quote | Triggered when a quote is updated. |
new.receipt | Triggered when a new receipt is created. |
updated.receipt | Triggered when a receipt is updated. |
new.revenue | Triggered when a new revenue entry is created. |
updated.revenue | Triggered when a revenue entry is updated. |
updated.setting | Triggered when a setting is updated. |
new.tag | Triggered when a new tag is created. |
updated.tag | Triggered when a tag is updated. |
deleted.tag | Triggered when a tag is deleted. |
new.transfer | Triggered when a new transfer is created. |
updated.transfer | Triggered when a transfer is updated. |
deleted.transfer | Triggered when a transfer is deleted. |
new.webhook | Triggered when a new webhook is created. |
updated.webhook | Triggered when a webhook is updated. |
deleted.webhook | Triggered 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.vat | Triggered when a new VAT entry is created. |
updated.vat | Triggered when a VAT entry is updated. |
deleted.vat | Triggered when a VAT entry is deleted. |
new.transaction | Triggered when a new transaction is created. |
updated.transaction | Triggered when a transaction is updated. |
deleted.transaction | Triggered when a transaction is deleted. |
deleted.invoice | Triggered when an invoice is deleted. |
deleted.quote | Triggered when a quote is deleted. |
deleted.receipt | Triggered when a receipt is deleted. |
deleted.revenue | Triggered when a revenue entry is deleted. |
new.attachment | Triggered when a new attachment is created. |
updated.attachment | Triggered when an attachment is updated. |
deleted.attachment | Triggered 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.export | Triggered when a new data export is created. |
edit.export | Triggered when an existing data export is edited. |
deleted.export | Triggered when a data export is deleted. |
new.account:connection | Triggered when a new account connection is created. |
edit.account:connection | Triggered when an account connection is edited. |
deleted.account:connection | Triggered when an account connection is deleted. |
new.expense_report | Triggered when a new expense report is created. |
edit.expense_report | Triggered when an expense report is edited. |
deleted.expense_report | Triggered when an expense report is deleted. |
updated.expense_report | Triggered when an expense report is updated. |
new.expense_report:user | Triggered when a new expense report for a user is created. |
updated.expense_report:user | Triggered when an expense report for a user is updated. |
deleted.expense_report:user | Triggered when an expense report for a user is deleted. |
new.accounting_code | Triggered when a new accounting code is created. |
edit.accounting_code | Triggered when an accounting code is edited. |
deleted.accounting_code | Triggered when an accounting code is deleted. |
new.accounting_code:transaction | Triggered when a new accounting code transaction is created. |
edit.accounting_code:transaction | Triggered when an accounting code transaction is edited. |
deleted.accounting_code:transaction | Triggered when an accounting code transaction is deleted. |
new.oauth_config | Triggered when a new OAuth configuration is created. |
edit.oauth_config | Triggered when an OAuth configuration is edited. |
deleted.oauth_config | Triggered when an OAuth configuration is deleted. |