Prerequisites
Before continuing, you should have already completed the following for this connector:Configure the Connector
Connector Profile
Link an Account
Link Account
How Fastbill webhooks are set up
On connection, StackOne calls Fastbill’s API with SERVICE: webhook.create using your email and API key to register one webhook (TYPE: url) for this connection, pointing at a delivery URL that carries a secret token. Fastbill then sends one HTTPS POST per event to that URL, StackOne routes it to your integration, and only the events you enable are dispatched. Disconnecting the account deletes the webhook (SERVICE: webhook.delete).
- No callback URL to copy, and no verification step to complete.
- Only the events you enable in StackOne are subscribed in Fastbill and delivered.
Available webhook events
Only the events you enable in StackOne are subscribed in Fastbill and delivered; each notification carries the specific event name in its type field.
Review customer events
Fired for customers in your Fastbill account.
- Customer Created (
customer.created) — Fired when a customer is created. - Customer Updated (
customer.updated) — Fired when a customer is updated. - Customer Deleted (
customer.deleted) — Fired when a customer is deleted.
Review contact events
Fired for customer contacts.
- Contact Created (
contact.created) — Fired when a contact is created. - Contact Updated (
contact.updated) — Fired when a contact is updated. - Contact Deleted (
contact.deleted) — Fired when a contact is deleted.
Review invoice events
Fired through an invoice’s lifecycle.
- Invoice Created (
invoice.created) — Fired when an invoice is created. - Invoice Completed (
invoice.completed) — Fired when an invoice is completed (finalized). - Invoice Canceled (
invoice.canceled) — Fired when an invoice is canceled.
Review estimate events
Fired for estimates (quotes).
- Estimate Created (
estimate.created) — Fired when an estimate is created. - Estimate Updated (
estimate.updated) — Fired when an estimate is updated.
Inspect the delivery format
Fastbill sends each notification as a single HTTPS POST with a JSON body (not batched). Top-level fields are id (a notification id), type (the event name, e.g. invoice.created), created (the notification timestamp) and the affected entity nested under its resource key (customer, contact, invoice, or estimate). StackOne maps type to the event type, the entity’s id (e.g. invoice.invoice_id) to the record id and created to the event timestamp, and passes the full body through as the event data.