Connect this destination to export audience membership into a Lob campaign, for use in Lob after you finish creative and send settings there.

This destination writes to your Lob account and is a good fit when you want to:

This maps to GrowthLoop Audiences:

Use it for	Audiences
Loading GrowthLoop audiences into a Lob direct mail campaign	✓

Prerequisites

Make sure you have:

A Lob account. If you do not have one, create a Lob account.
A Lob secret API key. Paste the full key. Test keys start with test_. Live keys start with live_. Copy it from API Keys in Lob.

Set up Lob as a destination

Field	Description
Destination Name	Name this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "Lob Direct Mail".
Sync Frequency	Set the default export frequency (for example, daily or weekly). You can override this setting for individual exports.
API Key	Paste the full Lob secret API key you've created. Test keys start with `test_`. Live keys start with `live_`.
Prefix for Personalization Fields (optional)	Prefix GrowthLoop adds to personalization fields. The default value is `fw`. Leave this blank for no prefix. If you set one, it must start with a letter and use up to 5 letters or numbers.

GrowthLoop validates the connection by listing campaign uploads in Lob. Lob then appears in your list of connected destinations.

From within GrowthLoop, export from an audience. See Export an audience if you need more information on these steps.

After building or selecting an audience, click Export, then search for Lob.

Map every required field. A row must include all five required values.

Match field	Required	Notes
Name	Yes	Recipient name
Address Street	Yes	Address line 1
Address City	Yes	City
Address State Abbr	Yes	State abbreviation
Address Zip	Yes	Postal code
Address Street 2	No	Address line 2
Company	No	Company name
Address Country	No	Map this for addresses outside the US

You can also map additional fields, including custom attributes from the audience. GrowthLoop sends those values as metadata on the campaign upload.

Setting	Audience export
Export Name	Defaults to the audience name. When Campaign Status is New, that is the Lob campaign name unless a campaign with that name already exists.
Campaign type	Choose a one-time or ongoing export.
Campaign Status	Choose New or Existing.
Campaign Id	Required when Campaign Status is Existing. Use the Lob campaign ID, which starts with `cmp_` followed by letters or numbers. Find it in the campaign URL in Lob.
Campaign Name	Required when Campaign Status is Existing. Must be under 40 characters.
Schedule	Set frequency, start date, end date, and days of the week for ongoing exports.

This is what GrowthLoop writes when you export an audience.

Behavior	What happens
What GrowthLoop writes	A CSV upload on a Lob campaign. Direction is GrowthLoop → Lob.
When it runs	GrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes.
New campaign	GrowthLoop creates a Lob campaign named after Export Name, then uploads the file. If a campaign with that name already exists, GrowthLoop reuses it.
Existing campaign	GrowthLoop uploads to the campaign ID you entered. The ID must already exist in that Lob account.
Match fields	Name, street, city, state abbreviation, and ZIP are required. Street 2, company, and country are optional.
Personalization	Additional fields are supported. GrowthLoop can prefix those names with Prefix for Personalization Fields, then writes them as `metadata_` columns on the upload.
Adds	GrowthLoop uploads current members as a new campaign upload. Multi-part audiences get a numbered filename, such as `{export name} - 1.csv`.
One-time exports	GrowthLoop sends current membership once.
Ongoing adds	Ongoing exports upload contacts who enter the audience on later runs. Each run creates another campaign upload on the same campaign.
Removes and deletes	GrowthLoop does not remove contacts from the Lob campaign and does not delete the campaign.

When the run finishes, confirm you can use the data in Lob.

Audience export: Log in to Lob, open Campaigns, and look up the campaign named after Export Name, or the existing campaign you selected.

In GrowthLoop, review counts on the audience Exports tab. See Export an audience for more information.

Congrats on successfully exporting to Lob!

These are the issues we see most often. You can always email us at [email protected] for help.

Problem	Cause	Resolution
Connection fails to validate	API Key is missing, invalid, or expired	Paste the full secret API key from API Keys. Use a key that starts with `test_` or `live_` for the environment you want
Existing campaign export fails	The Campaign Id does not exist in that Lob account	Enter a campaign ID from this account that starts with `cmp_`
Rows fail to export	A required address field is missing	Map Name, Address Street, Address City, Address State Abbr, and Address Zip
Contacts who left the audience still appear in Lob	GrowthLoop uploads adds only	Manage removals in the Lob campaign. Ongoing exports do not take contacts off the campaign