Ballast - Cold Email

Connect a new sending domain to the workspace and verify DNS. Registers a new sending domain under the workspace, saves it, and immediately initiates DNS and deliverability verification (MX, SPF, DKIM, DMARC, blacklists).

Add leads from lists (or by id) to a campaign. Skips leads already in the campaign, unsubscribed, bounced or suppressed leads, and addresses verification found invalid.

Connect a mailbox. Tests SMTP and IMAP login first and saves only when both pass. Google needs an app password. Microsoft 365 connects with OAuth from the dashboard.

Suppress addresses or whole domains. Up to 10,000 values per call: emails, or domains written as @acme.com. Matching leads are marked suppressed.

Inspect DNS and deliverability health of any domain without adding it. Performs a live, read-only diagnostic check on any domain name (MX, SPF, DKIM, DMARC records, blacklist status, and domain age) with actionable DNS fix instructions. Results are cached for 10 minutes. Nothing is saved to the workspace.

Create a draft campaign. Starts with one empty email, or with a saved or built-in template's sequence when templateId is given. The campaign is a draft until it is launched.

Plan, subscription status, emails and AI drafts used this period.

Get a campaign with its sequence, schedule and settings.

Multi-dimensional performance breakdown by provider, mailbox, and sentiment. Returns granular aggregate performance metrics broken down across email providers (Google Workspace, Microsoft 365, etc.), individual sending mailboxes, and reply sentiment classifications.

Daily time-series email metrics for a campaign or all campaigns. Returns daily time-series counts (day-by-day sent, replied, opened, bounced, positive) for a specific campaign (pass campaignId) or all campaigns combined over the last N days.

Inbox reply counts by label, mailbox and campaign.

What has to be fixed before launch. Required items block the launch; warnings are advice.

Workspace-wide aggregate email outreach totals and trends. Returns macro-level aggregate counts (total sends, replies, positive replies, bounces, won deals) across the entire workspace for the last 7, 30, or 90 days, comparing against the prior period for trend analysis.

A thread with every message, the campaign emails and the lead.

Import leads in chunks. Send up to 5,000 rows per call. The first call creates the import and returns its id; pass importId with every next chunk and final: true with the last. Addresses are deduped, suppressed ones skipped, invalid ones counted. ESP detection and verification run in the background after the final chunk. Asks for confirmation: the first call returns a preview and a confirm_token.

Set or clear a thread's label. The lead gets the label for the thread's campaign and the label's triggers run (suppress, stop in campaign, pause campaign, move to list). null clears it.

Launch or resume a campaign. Runs the launch checklist first and refuses when a required item fails. The worker then sends inside the schedule window. Asks for confirmation: the first call returns a preview and a confirm_token.

List campaigns. Newest first, with lead counts by progress.

List all connected sending domains and their verification status. Returns all custom sending domains currently registered in the workspace, including their mailbox count, latest deliverability scores, and verification history.

Lead lists with counts.

List leads. Paged, newest first by default. Filter by list, label, status, verification and ESP, or search email, name and company.

List mailboxes. Connected sending mailboxes with today's limit, ramp-up and the DNS health of their domain.

Reply threads, newest first. Filter by unread, label, mailbox or campaign. Page with cursor from the previous answer.

Pause a running campaign. Nothing more is sent until it is launched again. Emails already handed to the provider still arrive.

Render every step and variant for one lead. Shows the emails exactly as that lead would get them, with spintax resolved the way it will be for them. Defaults to the first lead in the campaign.

Answer a thread. Sends from the mailbox the conversation is on, in the same thread (In-Reply-To and References), to whoever wrote last. The previous message is quoted below. Asks for confirmation: the first call returns a preview and a confirm_token.

Replace the whole sequence. Steps in order, each with 1 to 5 variants. Bodies may be plain text (blank lines split paragraphs) or simple HTML. Use {{first_name}} style variables, {{first_name|there}} for a fallback, {Hi|Hello} spintax, and put {{unsubscribe}} in the first email. Only drafts and paused campaigns.

Rename a campaign or change its schedule, mailboxes and options.

Who am I: the user, workspace and plan behind this key or session.

Write emails with AI from the offer profile. Drafts a whole sequence (mode sequence) or a new version of one variant (rewrite, shorter, angle), using only facts from the workspace's offer profile and lead fields. Results are saved as new variants and never overwrite existing text; an empty campaign gets the drafted steps. Each email is checked against the content checklist; anything still failing comes back in problems. Requires that the workspace's offer profile is configured in Ballast settings (or updated via update_offer_profile).