Letterby Docs

Offers

Create an offer, set budgets, and understand statuses and pause reasons.

An offer is your newsletter in the marketplace: where readers land, what you pay per verified subscriber and how much you are willing to spend.

Open Advertiser, then Offers. You need the owner or admin role.

Create an offer

Select New offer and go through Basics, Budget, Audience and Review.

FieldRules
Offer name (internal)Up to 255 characters.
DescriptionUp to 256 characters.
Landing URLMust start with https://.
Payout per verified subscriber$1 to $1,000.
Monthly capOptional. $100 or more.
Lifetime capOptional. $100 or more.
CountriesUp to 50. Leave empty to accept subscribers from anywhere.
On quality failWhat happens to a subscriber who fails screening. See below.

Then choose:

  • Publish offer to go live now.
  • Save as draft to keep it private until you select Publish.

On quality fail

OptionResult
Keep, don't chargeThe subscriber stays on your list. You are not charged.
Remove from listLetterby unsubscribes them from your list. You are not charged.

Budgets

Each subscriber a creator sends holds its payout against your caps from signup until it is billed or rejected in screening. Caps count what is spent plus what is held, so you are never sent more subscribers than your budget covers.

CapWhen it is reached
Monthly capThe offer pauses. It resumes by itself on the 1st of the next month, or earlier when held subscribers fail screening.
Lifetime capThe offer pauses. It resumes by itself when held subscribers fail screening, or when you raise the cap.
Daily capNew charges wait until spend over the last 24 hours is back under the cap. The offer stays live. Set it under Edit.

Subscribers already held are billed as usual while the offer is paused. Every cap must cover at least one payout. You get an email when an offer pauses on a cap, and when it has used 80% of its monthly cap.

Edit an offer

Select Edit on the offer. You can change everything except the publication and the currency.

  • Payout. A new payout applies to creators who join from now on. Creators already promoting keep the payout they accepted.
  • Caps. A cap cannot be set below what the offer already spent plus the subscribers it holds.
  • Click ID URL param. Adds the tracking link's id to your landing URL under the name you choose, so you can attribute signups in your own analytics.

Creators promoting the offer are emailed when you change the payout or landing URL.

Statuses

StatusMeaning
DraftNot published. Only your team sees it.
ActiveLive in the marketplace.
PausedNot accepting subscribers. The reason is shown next to the badge.
Insufficient fundsYour balance ran out. It resumes when you add funds.
ArchivedClosed for good. Subscribers already added to your list are still screened and billed.

Why an offer is paused

Shown asCauseTo resume
manually pausedYou paused it.Select Resume offer.
monthly cap reachedThe monthly cap was used up.Wait for the 1st, or raise the cap.
lifetime budget spentThe lifetime cap was used up.Raise the cap.
insufficient escrowYour balance cannot cover a payout.Add funds.
reconnect your email providerYour provider key stopped working.Enter a new key.
open tracking offOpen tracking is off in your provider.Turn it back on.
paused by LetterbyOur team paused it.Contact support.

Resuming needs a balance of at least one payout.

If your email provider stays disconnected for 5 days, or you remove the connection, subscribers already added to your list are billed without screening. You get an email when it disconnects and a reminder on day 3.

Pause, resume and delete

Use the menu on an offer, or select several offers for Pause, Resume and Archive in bulk.

Delete offer archives it. This cannot be undone.

  • It leaves the marketplace at once and creators promoting it are notified.
  • Subscribers already verified are still paid to creators on the next payout.
  • If your balance does not cover those payouts, add funds first.

Duplicate

Open the offer's menu and select Duplicate to create a draft copy with spend reset.

On this page