Send a postcard from Zapier, Make or n8n
Mailr doesn’t need a native app in Zapier, Make or n8n: each one can send a postcard with a single HTTP request step. Point it at https://api.mailr.dev/v1/postcards, add your API key as a header, and map the trigger’s fields into the JSON body.
The request every tool sends
| Setting | Value |
|---|---|
| URL | https://api.mailr.dev/v1/postcards |
| Method | POST |
| Header | Authorization: Bearer mlr_test_… (your key) |
| Header | Content-Type: application/json |
| Body | The JSON below, with the trigger’s fields mapped in |
{
"size": "6x9",
"template": "tmpl_thank_you",
"to": {
"name": "{{full name from the trigger}}",
"line1": "{{street}}",
"city": "{{city}}",
"state": "{{state, 2 letters}}",
"zip": "{{zip}}"
},
"from": { "name": "Acme Outdoor", "line1": "1 Example Way", "city": "Phoenix", "state": "AZ", "zip": "85004" },
"merge": { "first_name": "{{first name}}", "promo_code": "TRAIL15" }
}Replace each {{…}} with the matching field from your trigger. The merge fields depend on the template: tmpl_thank_you needs first_name and promo_code.
Zapier: send a postcard from any Zap
- Add an action step: Webhooks by Zapier, event Custom Request.
- Method
POST, URL as above, and Data: paste the JSON body and insert your trigger’s fields. - Under Headers add
Authorization=Bearer mlr_test_…andContent-Type=application/json. - Test the step. A test key creates a postcard that never prints; you’ll see it in your dashboard.
Make
- Add the HTTP module, Make a request.
- URL as above, method
POST, and the two headers. - Body type Raw, content type JSON (application/json), then paste the body and map fields into it.
n8n: send physical mail from a workflow
- Add an HTTP Request node, method
POST, URL as above. - Authentication: Generic Credential Type → Header Auth, name
Authorization, valueBearer mlr_test_…. - Turn on Send Body, choose JSON, specify the body Using JSON, and paste it with expressions like
{{ $json.first_name }}.
Send letters or postcards from Google Sheets
Trigger on New Spreadsheet Row in Google Sheets with columns for name, street, city, state, ZIP and first name, then run the HTTP step above. Each new row becomes one postcard. To send letters instead, point the step at /v1/flats with size 8.5x11 and a flat template like the welcome letter. Keep a “sent” column the step fills in with the returned id so a row is never mailed twice.