Receive fax events with webhooks

​

What you can subscribe to

​

The envelope

{
  "id": "evt_8aZqRm4yT3vK7pNxJ2bH9c",
  "type": "fax.delivered",
  "created": 1747173600,
  "data": {
    "object": {
      "id": "fax_8aZqRm4yT3vK7pNxJ2bH9c",
      "status": "delivered",
      "to": "+12125551234"
    }
  }
}

​

Get started

1. Register a webhook endpoint in the dashboard or via POST /webhooks. You will receive a whsec_-prefixed signing secret. It is shown once.
2. Subscribe to events. Each endpoint can subscribe to all events or to a specific list.
3. Verify every request. See Verify webhook signatures. mintfax follows the Standard Webhooks specification, so you can use a reference library in your language without writing custom verification code.
4. Acknowledge with a 2xx response. Any 2xx status code is treated as successful delivery. Non-2xx responses or timeouts schedule a retry. See Delivery and retries.
5. Inspect attempts when something looks off. The dashboard shows every delivery attempt with status, response, and signature headers. See Inspect delivery attempts.

​

Headers on every delivery

​

Next

• Verify webhook signatures
• Delivery and retries
• Inspect delivery attempts
• Event types