How can I use webhooks to check the status of my sent or received fax?

Who can use this feature?

Available on Enterprise plan.

All members.

New: Webhooks got an update 
Webhooks now come with better configuration, delivery logs, event replay, and signature verification. If you configured webhooks before August 31, 2026, your endpoints still work, but you need to migrate them before October 2026. You can follow the migration steps.

Webhooks let you receive real -time updates about your sent and received faxes directly from Fax.Plus. By configuring webhooks, you can automate the monitoring of your fax transmissions and integrate status updates into your existing systems.

Webhooks Configuration

  1. Open the Webhooks pane :
    • Log in to your Fax.Plus account.
    • Navigate to the Integrations section under Settings.
    • Locate Webhooks and click Manage.
  2. Add an endpoint:
    • Click Add Endpoint and enter the absolute URL on your server that will receive the events.
    • Choose which events to receive. Subscribe to all events, or pick only the ones you need from
      the event catalog.
    • Optional: filter by fax number. Attach one or more of your fax numbers to only receive events for
      those numbers.
  3. Receive status updates

    • Once configured, Fax.Plus will send a webhook to your specified URL whenever a fax status
      changes.
    • The webhook payload will include important details such as the fax ID, status, timestamp, and
      recipient information.

    Note: If hook.id is not equal to data.id, the fax is being retried. If hook.id equals data.id, it indicates the fax is being sent for the first time

  4. Verify signature
    • For each endpoint created, a signing secret is automatically created that you can use to validate every incoming request against it. Learn more about verifying webhook signatures.
  5. (Optional) Verify origin IP addresses:
    • You can verify that the webhooks you receive are coming from our list of authorized IPs:
      • 52.215.16.239
      • 54.216.8.72
      • 63.33.109.123
      • 2a05:d028:17:8000::/56

Troubleshooting and Monitoring

  • Logs and observability: in the webhooks panel, you can see every event and whether it was delivered successful or not.
  • Retries: In case of delivery failure, webhooks are automatically retried.
  • Replay: You can also trigger manual retries from the panel, or replay any past events over a chosen time window.
Was this article helpful?
0 out of 1 found this helpful
More Articles in this section