> ## 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.

# Send faxes from Zapier

> Connect mintfax to Zapier so a trigger in any app sends a fax automatically.

## 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 (`mfx_test_...`). [Create one free](https://mintfax.com/register) if you have not already.
* A [Zapier](https://zapier.com) 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:

| Field                    | Value                                                                        |
| ------------------------ | ---------------------------------------------------------------------------- |
| Method                   | `POST`                                                                       |
| URL                      | `https://api.mintfax.com/v1/faxes`                                           |
| Payload Type             | `form`                                                                       |
| Data: `to`               | The recipient fax number in E.164 format, e.g. `+12015550100`                |
| Data: `file`             | Map this to the file field from your trigger, or paste a public URL to a PDF |
| Headers: `Authorization` | `Bearer mfx_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](/docs/sandbox) has the full list of magic numbers.

### 4. Add a webhook listener (optional)

If your Zap needs to react when a fax is delivered (or fails), create a second Zap with a **Webhooks by Zapier > Catch Hook** trigger. Copy the Catch Hook URL into your mintfax environment as a [webhook endpoint](/docs/webhooks/verify-requests). mintfax will post `fax.delivered` and `fax.failed` events to it, each signed with an HMAC header you can verify. The [events reference](/docs/webhooks/events/overview) documents the full payload schema.

## Deploy

Swap your sandbox key (`mfx_test_...`) for a live key (`mfx_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](/docs/cover-pages) covers token-based templating through the API.