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.
Related docs
- Segments and Audiences:
/docs/growth/segments-audiences - Webhook Events:
/docs/reference/webhook-events - Plan Limits:
/docs/pricing/limits