Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintfax.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Goal

Send a fax through mintfax whenever a Zapier trigger fires - new form submission, new spreadsheet row, incoming email, whatever the trigger.

​
Ingredients

  • A mintfax account with a sandbox API key (fx_test_...). Create one free if you have not already.
  • A Zapier account (free tier works for testing).
  • A PDF or document URL your Zap will fax.

​
Steps

​
1. Create a new Zap

In the Zapier dashboard, click Create Zap. Pick your trigger app and event - “New Form Submission” in Typeform, “New Row” in Google Sheets, or whatever starts the workflow. Connect the trigger account and test it so Zapier has sample data to work with.

​
2. Add a Webhooks by Zapier action

Add an action step. Search for Webhooks by Zapier, then select Custom Request. Configure the fields:
FieldValue
MethodPOST
URLhttps://api.mintfax.com/v1/fax
Payload Typeform
Data: toThe recipient fax number in E.164 format, e.g. +12015550100
Data: fileMap this to the file field from your trigger, or paste a public URL to a PDF
Headers: AuthorizationBearer fx_test_abc123def456
The key above is a sandbox placeholder. Swap in your own key when you go live.

​
3. Test in the sandbox

Set to to the sandbox success number +15005550001 and send a test request. You should get back a 201 with status: "queued". Try +15005550002 for a busy line, or +15005550004 for a transient failure that succeeds on retry. The sandbox guide has the full list of magic numbers.

​
4. Add a webhook listener (optional)

If your Zap needs to react when a fax lands (or fails), create a second Zap with a Webhooks by Zapier > Catch Hook trigger. Copy the Catch Hook URL into your mintfax workspace as a webhook endpoint. mintfax will post fax.delivered and fax.failed events to it, each signed with an HMAC header you can verify. The events reference documents the full payload schema.

​
Deploy

Swap your sandbox key (fx_test_...) for a live key (fx_live_...), replace the sandbox number with a real recipient, and turn the Zap on. Watch the first few deliveries in the mintfax dashboard or through webhook events to confirm everything is working.

​
Variations

  • Add a Zapier Filter step before the webhook action to fax only when a field matches a condition (e.g., country == US).
  • Use a Google Sheets trigger with Looping by Zapier to send one fax per row.
  • If your workflow generates cover pages, merge the cover and body into a single PDF before the webhook step. The cover pages guide covers token-based templating through the API.