Campaigns That Run Themselves

Creates a new campaign or updates an existing one in a single call. Omit campaign_id to create (requires name, kind, and either a list_id or inline contacts) or provide it to update. Choose acquisition for invite-based outreach to new first-degrees or relationship for DM-only outreach to existing connections, with a URL-safe slug auto-derived from the name.

upsert_campaign

Renders a read-only launch preview for a campaign before any message goes out. Returns up to 10 personalized first-touch messages (configurable up to 50), a summary of the prospect list, blacklist hits, and duplicate hits. Use it to sanity-check personalization and audience quality before confirming a launch.

preview_campaign_launch

Confirms and enables a campaign after checking launch readiness. Every campaign needs a bound list, and relationship campaigns also need a non-empty message; incomplete campaigns return a structured refusal and remain disabled. The action is idempotent for an already-enabled, ready campaign.

confirm_campaign_launch

Fetches campaign data for one campaign or lists all of them. Omit campaign_id to list every campaign in your workspace, or pass one with include[] to load the health funnel, action stats, account health, and outreach config in parallel. Returns metadata only by default and supports forced recompute of included slices.

get_campaign

Inspection-only while variant execution is unavailable. action='list' returns stored definitions; action='add' and action='remove' fail with VARIANTS_NOT_APPLIED before any write.

manage_variants

Fails with VARIANTS_NOT_APPLIED while configured variant copy is not selected by the send paths. This prevents plausible-looking attribution for an experiment that did not run.

get_variant_stats

Applies a built-in sequence template to a campaign, copying its follow_up steps as-is into the campaign's follow_up_sequence. The template's follow-ups carry no daily limit and write to the follow-up sequence rather than the main sequence. Fails if the template_name or campaign_id is invalid.

apply_sequence_template

Lists the built-in sequence templates available to apply to a campaign. Each entry returns its name, description, and step count so you can pick a proven outreach structure quickly. Returns an empty array if no templates are found.

list_sequence_templates

Manages the pool of sender accounts on a campaign. Use action='list' to see configured senders, 'add' to bring a sender into the round-robin pool (daily limits split evenly across senders), or 'remove' to hard-delete a sender (contacts are reassigned at the next cron, not immediately). Fails if the campaign is not found, the sender is already added, or the sender to remove is not found.

manage_senders

Configures or controls a campaign's outreach engine. With action='setup' you write the ordered steps (warmup actions, the auto-firing invite, then follow-up messages), daily_invites, invite_message, and list_id, while pause and resume toggle sending. Pausing holds pending follow-ups, but each expires 14 days after its scheduled send_at; the pause response reports held_follow_ups and earliest_expiry_at. Omit steps to preserve existing ones, pass [] to clear them, and note that text DM follow-ups use type='message'.

manage_outreach

Update the safeguards that decide which contacts are eligible to enter your outreach campaigns. Set account-wide defaults by omitting campaign_id, or apply a per-campaign override using a tristate of 'skip', 'allow', or null (inherit the default). Toggles cover pending invitations, unsubscribes, blocklist membership, recently messaged contacts, same-sender or cross-sender touches, other active acquisition campaigns, and already-connected profiles. Omit any field to leave it unchanged.

set_enrollment_policy

Archives a campaign and permanently cancels every queued pending or retry follow-up. Preview first to see the exact cancellation count. Unarchive restores the campaign record but does not restore cancelled follow-ups or re-enable outreach. Sent-message, activity, and reporting history remains available. Fails with not found if the campaign_id does not exist.

archive_campaign