First-party app
Instantly

Instantly

Manage Instantly cold-email campaigns, leads, sending accounts and the Unibox over API v2.

stable MarketingEmailCustomer Relationship Management

About

Instantly ships in the w6w first-party pack. It declares 38 actions, 2 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.instantly
Version
0.1.0
Author
w6w
Licence
MIT
Categories
Marketing · Email · Customer Relationship Management

Overview

Instantly is a cold-email outreach platform: campaigns of scheduled email sequences sent from a pool of connected sending accounts, with lead tracking, interest-status labeling and a shared inbox (Unibox) for replies. This app covers the run-and-read path a workflow actually needs against Instantly’s API v2 — create, launch, pause and read back campaign analytics; add, search, update and move leads between campaigns and lists; list and manage the sending accounts a campaign draws from, including their warmup and daily-volume analytics; and read, reply to or forward the emails a campaign receives.

Every path, verb and field was verified against Instantly’s own OpenAPI 3.0 document rather than inferred from a sibling app or a community integration. Two vendor realities shaped the design: creating a sending account means handing Instantly that mailbox’s own IMAP/SMTP password as a request field (a legitimate, vendor-required exception to the credential-only-in-sign rule, since that password belongs to the mailbox being provisioned, not to this app’s own Connection), and API keys are scope-gated per resource, so a key scoped away from Campaigns will see the health probe refuse with a distinguishable ‘insufficient scope’ message rather than a bare failure.

Build with Instantly

Three routes to the same 38 actions. The Workflow tab is generated from Instantly's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Connect Sending Account

account-create

Connect a mailbox to the workspace over IMAP/SMTP as a sending account.

Get Daily Account Analytics

account-daily-analytics-get

Emails sent per day, per sending account. Defaults to the trailing 30 days.

Disconnect Sending Account

account-delete

Permanently disconnect a sending account. Returns its last state.

Get Sending Account

account-get

Read a single sending account by email.

List Sending Accounts

account-list

List the workspace's connected email sending accounts.

Mark Sending Account Fixed

account-mark-fixed

Mark a sending account's error as resolved so Instantly resumes sending from it.

Update Sending Account

account-patch

Update a connected sending account's settings.

Pause Sending Account

account-pause

Pause a single sending account.

Pause Sending Accounts in Bulk

account-pause-bulk

Pause up to 100 sending accounts in one call.

Resume Sending Account

account-resume

Resume a paused sending account.

Get Warmup Analytics

account-warmup-analytics-get

Get per-day and aggregate warmup send/receive/inbox/spam counts for sending accounts.

Activate / Resume Campaign

campaign-activate

Start a draft campaign or resume a paused one — Instantly uses the same endpoint for both.

Get Campaign Analytics

campaign-analytics-get

Get engagement analytics for one, several, or (leaving id/ids empty) every campaign in the workspace.

Get Campaign Analytics Overview

campaign-analytics-overview-get

Get aggregate engagement and interest-status totals across one, several, or every campaign.

Create Campaign

campaign-create

Create a campaign. A schedule is required even for a campaign you plan to launch later.

Delete Campaign

campaign-delete

Permanently delete a campaign. Returns the deleted campaign's last state.

Duplicate Campaign

campaign-duplicate

Create a copy of a campaign. Defaults the new name to "<original name> (copy)" when left empty.

Get Campaign

campaign-get

Read a single campaign by ID.

List Campaigns

campaign-list

List campaigns in the workspace, newest first, with optional name search and status filters.

Update Campaign

campaign-patch

Update a campaign. Only the fields you set are changed.

Pause Campaign

campaign-pause

Stop (pause) a running campaign.

Get Campaign Sending Status

campaign-sending-status-get

Explain why a campaign is not sending, or is sending slower than expected.

Forward Email

email-forward

Forward an existing email to another recipient.

Get Email

email-get

Read a single email by ID.

List Emails

email-list

List emails a campaign sent or received (the Unibox). Rate limit: 20 requests/minute, tighter than this app's other actions.

Reply to Email

email-reply

Send a reply to an existing email from the Unibox.

Mark Thread as Read

email-thread-mark-read

Mark every email in a thread as read.

Count Unread Emails

email-unread-count-get

Get the total number of unread emails in the Unibox.

Add Leads in Bulk

lead-bulk-add

Add up to 1,000 leads to a campaign or a list in one call. Validates emails and checks them against blocklists and existing leads.

Delete Leads in Bulk

lead-bulk-delete

Delete multiple leads from a campaign or list, optionally filtered by status or specific IDs.

Create Lead

lead-create

Create a single lead in a campaign or a lead list.

Delete Lead

lead-delete

Permanently delete a single lead. Returns the deleted lead's last state.

Get Lead

lead-get

Read a single lead by ID.

Search Leads

lead-list

Search leads by campaign, list, filter or free-text search.

Move Leads

lead-move

Move (or copy) leads matching a filter to a different campaign or list. Returns a background job; the move runs asynchronously.

Update Lead

lead-patch

Update a lead's profile fields. Set at least one.

Update Lead Interest Status

lead-update-interest-status

Set (or clear) a lead's interest status by email — the same action as dragging a lead between CRM columns in the app.

Get Workspace

workspace-get

Read the current workspace's details. Requires the workspaces:read scope specifically.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Instantly's real ids.

{
  "manifestVersion": "2",
  "name": "instantly-example",
  "steps": [
    {
      "id": "account-create",
      "uses": {
        "app": "io.w6w.instantly",
        "action": "account-create",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "email": "<email>",
        "first_name": "<first_name>",
        "last_name": "<last_name>"
      }
    }
  ]
}

Here are some of the things you can do

  • Connect Sending Account

    perform
    account-create
  • Get Daily Account Analytics

    read
    account-daily-analytics-get
  • Get Sending Account

    read
    account-get
  • List Sending Accounts

    search
    account-list
  • Mark Sending Account Fixed

    perform
    account-mark-fixed

+33 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Instantly, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Instantly. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "account-create",
  payload: {
    email: "<value>",
    first_name: "<value>",
    last_name: "<value>",
    provider_code: "<value>",
    imap_username: "<value>",
    imap_password: "<value>",
    imap_host: "<value>",
    imap_port: "<value>",
    smtp_username: "<value>",
    smtp_password: "<value>",
    smtp_host: "<value>",
    smtp_port: "<value>",
    // daily_limit: "<value>",
    // signature: "<value>",
    // reply_to: "<value>",
    // skip_cname_check: "<value>",
    // warmup: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action account-create --payload '{"email":"<value>","first_name":"<value>","last_name":"<value>","provider_code":"<value>","imap_username":"<value>","imap_password":"<value>","imap_host":"<value>","imap_port":"<value>","smtp_username":"<value>","smtp_password":"<value>","smtp_host":"<value>","smtp_port":"<value>"}'

Give an AI agent Instantly — without giving it Instantly's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.instantly#account-create",
    "input": {
      "email": "<email>",
      "first_name": "<first_name>",
      "last_name": "<last_name>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Instantly connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Instantly's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Instantly itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Instantly declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Instantly platform status

No machine-readable or HTML status page was found for Instantly as of 2026-08-29 (status.instantly.ai does not resolve; both statuspage.io subdomains one would guess redirect to statuspage.io's own homepage rather than a claimed page), so this app declares the absence rather than guessing at an undocumented endpoint.

quota

Request-rate headroom

Instantly documents fixed, workspace-wide ceilings (100 requests/second, 6,000 requests/minute, shared with API v1) but exposes no response header or endpoint that reports current consumption against them (verified live 2026-08-29), so there is nothing to probe ahead of a 429.