Direct mail for growth teams, with an API underneath. Read the docs →

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

SettingValue
URLhttps://api.mailr.dev/v1/postcards
MethodPOST
HeaderAuthorization: Bearer mlr_test_… (your key)
HeaderContent-Type: application/json
BodyThe 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

  1. Add an action step: Webhooks by Zapier, event Custom Request.
  2. Method POST, URL as above, and Data: paste the JSON body and insert your trigger’s fields.
  3. Under Headers add Authorization = Bearer mlr_test_… and Content-Type = application/json.
  4. Test the step. A test key creates a postcard that never prints; you’ll see it in your dashboard.

Make

  1. Add the HTTP module, Make a request.
  2. URL as above, method POST, and the two headers.
  3. Body type Raw, content type JSON (application/json), then paste the body and map fields into it.

n8n: send physical mail from a workflow

  1. Add an HTTP Request node, method POST, URL as above.
  2. Authentication: Generic Credential Type → Header Auth, name Authorization, value Bearer mlr_test_….
  3. 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.

The request in this guide is the same one the code guide sends, which we run against the API before each update. The steps in each tool follow their current menus; if a label has moved, look for the HTTP or webhook request action.