Help with FreeAgent API Webhooks for Invoice Status Updates

Hi everyone,

I’m currently working on integrating FreeAgent’s API into our system, and I need some guidance on setting up webhooks for invoice status updates. The goal is to receive real-time notifications whenever an invoice’s status changes (e.g., from “Draft” to “Sent” or “Paid”).

I’ve gone through the webhooks documentation, but I still have a few questions:

  1. Webhook Event Triggers – Are there specific event types related to invoice status changes, or should I subscribe to general invoice updates and filter the relevant changes myself?
  2. Delivery Reliability – How reliable are FreeAgent’s webhooks? Are there any built-in retry mechanisms in case of failures, or should I handle this on my end?
  3. Security Best Practices – What’s the recommended way to validate webhook requests? Should I rely on the X-FreeAgent-Signature header, or is there another approach I should consider?
  4. Testing Webhooks – Is there a built-in way to test webhook payloads in a sandbox environment before deploying to production?

I also checked this: https://api-discuss.freeagent.com/t/updating-status-on-new-invoice-through-api-salesforce-developer

If anyone has experience with setting up FreeAgent webhooks, I’d appreciate any insights or best practices you can share! Thanks in advance.

FreeAgent doesn’t have webhooks. They were almost introduced a while back but then scrapped (unfortunately).