Docs

Approvals

Read, edit, approve or skip the runs that wait for you.

Who can use this: Any plan. Any role. Needs: An automation set to Approve each run, or a run on hold. A payment method to approve.

Overview

Approvals holds each run that waits for a person before it mails. A run waits when its campaign is set to Approve each run. A run also waits when LettrLabs holds it, for example after a failed payment. The page shows each event on a map, with what it would mail and what it would cost.

You can use Approvals to:

  • See each run and event that waits for you, and how soon it expires.
  • Review and approve a run, or skip it.
  • Change the homes, the template or the holdout of a run before you approve it.
  • Get an email when a storm waits for you.

How approvals work

An automation with Approve each run holds each run until you approve it. Auto-approve mails each run when it is ready. You set the choice on the Budget step of Send Mail.

A run waits until you decide, or until it expires. The campaign sets the time in Approval expires after, from 1 to 30 days. A run that nobody approves in that time expires and mails nothing.

LettrLabs can also hold a run or a touch for a check. These are the common reasons:

ReasonWhat it means
Payment failedThe payment failed. LettrLabs tries the card again once a day.
Far more homes than usualThe run found far more homes than the campaign usually mails.
Above the price ceilingThe price of the run is above the most the campaign pays.
Not enough discount codesA coupon list has fewer free codes than the homes to mail.
Merge field missingA merge field has no value for any home, and the touch has no fallback.
Plan does not include automationsYour plan does not include automations, so the automation is paused.

The tabs of the page show each run by its state:

TabWhat it shows
Needs approvingThe runs that wait for you.
ApprovedThe runs that you approved.
SkippedThe runs that you skipped, and the runs that were canceled.
ExpiredThe runs that nobody approved in time.
AllEvery run and event.

A waiting run that expires in less than one day shows the hours left on its card.

Approve or skip a run

Do this when the left navigation shows a count beside Approvals.

Approve and pay charges the run at once and mails real cards. LettrLabs uses your balance first, then your payment method.

In the left navigation, click Approvals. The Needs approving tab opens.

Optional: In Search events, enter a name. Click Filters to filter by Event type, Source, Status, Area, Impacted structures or the campaign.

Click an event in the list. The map shows its area, and the panel shows the homes, the cost and the card.

The Approvals page with the event list, the map and the event panel.
The Approvals page, with a hail event selected and its Skip and Review and send buttons.

To mail it, click Review and send. The review page of the run opens.

Check the Order summary, then click Approve and pay.

To skip it, click Skip. In the Skip this event? dialog, click Skip event.

A skipped run cannot be approved later. A skipped storm event can be approved again until it expires.

You're done when the run leaves the Needs approving tab. An approved run shows on the Approved tab, and its cards go to production.

Edit a run before you approve it

Do this to change the homes, the template or the holdout of one run. The campaign keeps its own settings.

Approve and pay charges the run. A card payment can add a processing fee to the part that your balance does not cover.

On the Approvals page, click the event, then click Review and send.

In Severity band or Severity threshold, widen or narrow the range of the event that gets a card.

In Max homes or Max mail quantity, set the most cards this run sends. The homes with the highest severity come first.

The review page of a storm event with the severity range, the max mail quantity and the order summary.
The review page of a storm event, with the severity range and the Order summary.

Optional: Set the Holdout, the share of homes to hold back.

Optional: In Card template, click Change and pick another template.

Check the Order summary, then click Approve and pay.

A storm event also offers Advanced targeting: the Property type, the Occupancy and the Targeting strategy. Maximum reach mails every home inside the impacted area. High accuracy mails the homes that the weather maps confirm.

A value that a playbook sets shows its limits. A Processing payment dialog shows while the payment runs. Keep the page open.

You're done when the run shows Approved. The cards go to production with your changes.

Manage alert emails

Do this to get an email when a storm waits for your review.

On the Approvals page, click Manage alert emails.

In Alert emails, enter an email address, then press Enter.

The Manage alert emails dialog with two email addresses.
The Manage alert emails dialog, with two addresses in Alert emails.

Add more addresses, or remove one.

Click Update.

The list must hold one address at least.

You're done when the message "Storm alerts updated." shows.

Act on a held touch

Do this when a touch of a campaign waits on the Approvals page with a hold reason.

A skipped touch does not mail. Skip also cancels the later touches of that run.

On the Approvals page, click the held touch. The Held touch panel shows the reason.

Do the fix that the panel names, when it names one. For example, click Add coupons or Edit the campaign.

To mail the touch, click Approve and send. When the campaign is paused, the The campaign is paused dialog opens first. Click Retry to continue.

In the Approve and send? dialog, click Approve and send.

To drop the touch, click Skip. In the Skip this held touch? dialog, click Skip touch.

The fixes depend on the reason. For Plan does not include automations, upgrade your plan and activate the automation. For Template no longer available, get access to the design again. To keep the touch as it is, click Keep it on hold.

You can also retry or cancel a held touch from its campaign page. Automated campaigns gives the steps.

You're done when the touch leaves the Needs approving tab.

FAQ

Steps checked 2026-11-16.

On this page