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

GoHighLevel direct mail: a postcard from any workflow

GoHighLevel direct mail with Mailr is one Custom Webhook action: when a contact reaches it, HighLevel posts their address to Mailr with your key as a Bearer token, and Mailr prints the postcard, adds postage and mails it.

What to mail from GoHighLevel

When this happensMail this
Appointment Status changes to Showed, then a 7-day WaitA review request card. (Review request)
Opportunity Status Changed, moved to WonA founder welcome letter, mailed flat. (Welcome letter)
Contact Tag added (for example, send-thank-you)A thank-you card with a promo code. (First-order thank you)

Set it up

  1. Add the action. In the workflow, after your trigger (and any Wait), add the Custom Webhook action. Set Event to CUSTOM, Method to POST, the URL to https://api.mailr.dev/v1/postcards and Content-Type to application/json.
  2. Add your key. Under Authorization choose Bearer Token, then Create New Key: name it Mailr and paste your mlr_test_ key. HighLevel stores it masked, for this sub-account only.
  3. Add the header and body. Add a header Idempotency-Key with the value review-{{contact.id}}. Paste the raw body below and change the return address, the service name and the review link.
  4. Test, then go live. Run a test contact with a full US address through the workflow and open Execution Logs to see Mailr's response, with the postcard id. When it works, update the key to your mlr_live_ key.

The Custom Webhook action

{
  "size": "4x6",
  "template": "tmpl_review_request",
  "to": {
    "name": "{{contact.name}}",
    "line1": "{{contact.address1}}",
    "city": "{{contact.city}}",
    "state": "{{contact.state}}",
    "zip": "{{contact.postal_code}}"
  },
  "from": { "name": "Bright Smile Dental", "line1": "1 Example Way", "city": "Phoenix", "state": "AZ", "zip": "85004" },
  "merge": {
    "first_name": "{{contact.first_name}}",
    "product_name": "your cleaning",
    "review_url": "brightsmile.co/review"
  }
}
  • Custom Webhook is a premium workflow action: $0.01 per execution, or covered by a paid Workflow Pro allowance. The agency is billed and can rebill sub-accounts.
  • The plain Webhook action can't call Mailr: it sends HighLevel's own contact payload and has no place for the Authorization header Mailr needs.
  • Mailr needs a two-letter state, and HighLevel keeps whatever was entered; its own merge-field list shows Illinois as an example. Collect state as a two-letter dropdown on your forms, or Mailr answers 422 with field to.state, which shows in Execution Logs.
  • HighLevel puts merge values into the body as they are, so it can't trim them. Mailr's limits are first_name 14 characters, product_name 22 and review_url 28; a longer value fails with a 422 instead of printing cut off.
  • A contact with no street address fails the same way. Put an If/Else step before the webhook that checks the address isn't empty.

What it costs

Each live piece is paid from your Mailr balance, printing and postage included: a 4x6 postcard is $0.85, a 6x9 $0.89 and an 8.5x11 letter $0.95 on pay as you go, less on a plan. Test pieces are free. All prices.

Templates that fit: Review request (4x6), Welcome letter (8.5x11), First-order thank you (6x9).

Questions

Is there a Mailr app in the HighLevel Marketplace?

No. Mailr has no HighLevel app, so there's no custom action to install. The Custom Webhook action calls Mailr's REST API directly, and the key stays in HighLevel's masked key store.

Can I mail a letter instead of a postcard?

Yes. Change the URL to https://api.mailr.dev/v1/flats, the size to 8.5x11 and the template to tmpl_welcome, with merge values first_name, company ({{contact.company_name}}) and founder_name.

How do I see whether the card was delivered?

Mailr has no webhooks yet, so it can't push status back into HighLevel. Execution Logs show the postcard id; look it up in the Mailr dashboard or with GET /v1/postcards/{id}.

Can an agency use one Mailr account for every client?

Yes. Each sub-account stores the key on its own, and the from address in each body sets whose return address prints. Mailr's Agency plan lowers the price per piece, to $0.66 for a 4x6 postcard.

The code on this page is written against the Mailr API as it works today. Test it with your test key first; nothing prints until you use a live key.
GOHIGHLEVEL

Mail from GoHighLevel today

Get a free test key, send one postcard to yourself and watch it move through every status.

  • Postcards, flats and folded mailers
  • A proof before anything prints
  • Free test mode: nothing prints, nothing charges
  • A status for every piece

Download the template kit?

mailr-kit.zip · about 190 KB · 47 text files

Only HTML, JSON and Markdown files. No programs, scripts or macros, nothing that installs or runs.