Skip to main content

Setup Guide: Zapier

How to connect LettrLabs to Zapier and trigger mail sends from any app.

A
Written by Adam Rutkowski

Zapier connects LettrLabs to thousands of other apps — your CRM, a spreadsheet, Slack, and more — so you can trigger direct mail automatically without writing any code. You build a "Zap": a workflow with a Trigger from another app (for example, a new row in a Google Sheet, or a deal closing in your CRM) and an Action that tells LettrLabs what to do with that data, such as adding a recipient to a mailing or kicking off a radius mailing around an address.

LettrLabs connects to Zapier using an API key that you generate from inside your LettrLabs account, then paste into Zapier when you connect the LettrLabs app there.

Before you start

  • A Zapier account (a free account is enough to get started).

  • A LettrLabs card template you want to use for the mailing, or plan to create one during setup.

  • Access to whatever app will trigger your Zap (CRM, spreadsheet, form tool, etc.).

Step 1: Generate a LettrLabs API key for Zapier

  1. From your LettrLabs dashboard, open Automations and select the Zapier card.

  2. Enter a Description for your key so you can identify it later (for example, "Zapier - HubSpot") and click Generate Key.

  3. Copy the key that appears. For security, it is shown only once — if you lose it, you'll need to revoke it and generate a new one from Manage Keys, so store it somewhere safe before closing the window.

Step 2: Create an Integration Order to receive recipients

An Integration Order is the mailing that Zapier will feed recipients into — it holds the template, postage settings, and status for that automation. After generating your key, click Create my first Zapier Automation to start one, choose the template you want to mail, and give the automation a name you'll recognize later.

A new automation starts out in a non-live status so you can test it safely — nothing is mailed until you switch it to Active (see Step 6).

Step 3: Connect LettrLabs inside Zapier

  1. Log in to Zapier and search for the LettrLabs app when adding a new connection or building a Zap step.

  2. When prompted to authenticate, paste in the API key you copied in Step 1.

  3. Once connected, that LettrLabs account is available to every Zap you build going forward — you only need to add the API key once.

Step 4: Choose what triggers your Zap

Pick the app and event that should kick off the mailing — a new or updated row in a spreadsheet, a new contact in your CRM, a form submission, or one of the thousands of other apps Zapier supports. This is standard Zapier configuration on the trigger app's side and works the same way regardless of which app you choose.

Step 5: Add a LettrLabs action

Add an action step, search for LettrLabs, and choose the action that matches what you want to happen:

  • Add Recipient to Integration Order — sends a single recipient's name and address (plus optional custom fields and up to six variable image URLs) into the Integration Order you created in Step 2. Use this when your trigger app already has a full mailing address to send to (e.g., a new CRM contact or spreadsheet row).

  • Mail Recipients Around an Address (Radius Mail) — instead of a single recipient, this searches for and mails a batch of neighbors around a "pin" address you provide. You set how many recipients to find, and can optionally filter by owner/renter status, property type, household income, length of residence, and year built.

  • Add Recipient to Address Book — adds a recipient's name and address to your LettrLabs address book without tying it to a specific Integration Order, for workflows where you're building a reusable contact list rather than triggering an immediate mailing.

Whichever action you choose, select the LettrLabs account you connected in Step 3, then choose (or type) the ID of the Integration Order you want to send to, and map the fields from your trigger app to the corresponding LettrLabs fields.

Step 6: Test, then go live

  1. Run Zapier's test step. A successful test sends a sample recipient into your Integration Order — check the LettrLabs portal to confirm it shows up with the fields you expect. While the automation is still in its testing status, recipients are not mailed; they're only used to validate your setup.

  2. Once the test looks right, publish your Zap in Zapier.

  3. Back in LettrLabs, open the automation and switch its status to Active. From that point on, every recipient your Zap sends over will actually be printed and mailed according to the template, postage, and settings you configured.

  4. You can switch an automation back to Inactive at any time to pause it without losing your configuration.

Managing your API keys

From Automations > Zapier > Manage, you can generate additional API keys (useful if you want a separate key per Zap or per CRM) and revoke keys you no longer need. Revoking a key immediately breaks any Zaps that authenticate with it, so create a replacement key first if you plan to keep the automation running.

Did this answer your question?