Skip to content

Growth

Campaigns

Plan campaign lifecycle, audience targeting, campaign events, and email/SMS capacity boundaries.

Before you start

Campaign docs are Preview while dedicated campaign API pages are completed. Use the Lamba console for campaign setup, templates, audiences, and launch controls, then use public events and limits to integrate the campaign lifecycle into your product operations.

What you build

A campaign workflow should define:

  • Project and environment scope
  • audience definition
  • channel and template
  • launch or schedule state
  • delivery and completion events
  • plan limit handling
  • audit trail and reconciliation

Implementation steps

1) Scope the campaign

Campaigns should belong to one Project and environment. Do not mix sandbox audiences with production delivery.

2) Configure launch details in the console

Choose the channel, template, schedule, audience, and send limits for the selected Project environment before launch.

3) Resolve the audience

Use membership, session, lifecycle, and segment facts to decide who qualifies. Store enough detail to explain the campaign later.

4) Apply capacity limits before launch

Plan copy references active campaign limits, audience per campaign, email campaigns per month, notification campaigns per month, templates, included campaign email volume, and overage behavior.

5) Consume public events

Webhook catalog includes campaign.sent. Downstream consumers should treat campaign events as immutable facts and deduplicate by event ID.

6) Reconcile delivery

Track launch outcome, delivery counts, failures, retries, and unsubscribe or consent decisions in the channel system that owns delivery.

API coverage note

Until a dedicated public Campaign API reference is published, use the console for authoring and use webhook delivery, audit events, and 402 plan-limit responses for external integration.

Security and operational notes

  • Do not send secrets or bearer tokens in campaign payloads.
  • Keep audit records for launch, pause, template changes, and delivery retries.
  • When a campaign exceeds plan capacity, show a clear upgrade or add-on path.

Troubleshooting

If a campaign cannot launch, check Project scope, audience size, active campaign count, included email volume, and whether the channel is available on the selected plan.

  • Segments and Audiences: /docs/growth/segments-audiences
  • Webhook Events: /docs/reference/webhook-events
  • Plan Limits: /docs/pricing/limits