Webhooks

Keep your external systems in sync without polling. Webhooks let CifraHQ push a notification to any HTTP endpoint the moment something happens: an invoice posts, a customer is created, a payment is recorded. Your receiving system gets the data immediately, with no manual export or scheduled job required.

Where to find it

Go to Setup > System > Webhooks.

How to create a webhook

1. Click New.
2. Enter a Name - a label for your own reference (e.g., Shopify Order Sync or ERP Invoice Feed).
3. Enter the URL - the endpoint on your server that will receive the POST request.
4. Optionally enter Headers (one per line, e.g., Authorization: Bearer my-token) to satisfy any authentication requirements your endpoint enforces.
5. Optionally add a Description to document what this webhook is for.
6. Save.

CifraHQ will immediately start sending HTTP POST requests with a JSON payload to your URL whenever a matching event occurs.

Editing a webhook

Click the webhook name in the list to open the edit dialog and update any field.

Deleting webhooks

Select one or more webhooks and click Delete.

Tips

• Use the Headers field to pass a shared secret, Bearer token, or API key so your endpoint can verify that requests are coming from CifraHQ and not an unknown source.
• Webhooks are tenant-specific: each company account has its own webhook list, so you can configure different integrations per tenant without them interfering with each other.
• Your receiving endpoint should return a 2xx HTTP status to acknowledge receipt. CifraHQ logs delivery failures so you can diagnose connectivity issues without hunting through server logs.

Related: CifraHQ API · Workflows · System Logs · Invoices · Vendor Bills