Instantly connector for AI agents

Tools your outbound agent reaches for on Instantly, scoped per user.

CALL ANY TOOL

94 tools for cold email in Instantly: create, launch, and pause campaigns and subsequences, add, move, and label leads, reply from the Unibox, manage sending accounts, warmup, and block lists, and read analytics.

instantly_account_campaigns_list

List account campaigns

List the campaigns that use a given sending account. Returns campaign IDs, names and statuses, plus next_starting_after. Use instantly_account_campaigns_list before pausing or deleting an account.

Parameters

Name

Type

Required

Description

string

Required

Email address of the sending account, as listed by instantly_accounts_list. Example: "john@acme-mail.com".

limit

number

Optional

Number of campaigns to return per page. Example: 25.

starting_after

string

Optional

Pagination cursor. Pass the next_starting_after value from the previous response to get the next page. Leave empty for the first page. Example: "0199a4b2-6c1e-7a3d-9f20-4b5c6d7e8f90".

instantly_account_delete

Delete account

instantly_account_get

Get account

instantly_account_mark_fixed

Account mark fixed

instantly_account_update

Update account

instantly_accounts_pause

Pause accounts

instantly_accounts_warmup_analytics_get

Get accounts warmup analytics

instantly_block_list_entries_delete

Delete block list entries

instantly_block_list_entry_update

Update block list entry

instantly_campaign_activate

Activate campaign

instantly_campaign_analytics_overview_get

Get campaign analytics overview

instantly_campaign_create

Create campaign

Create a new email campaign with a sending schedule, optional email sequence and sending settings. Returns the created campaign with its id and status 0 (Draft). Use instantly_campaign_create to set up outreach, then add leads with instantly_leads_add and start it with instantly_campaign_activate.

Parameters

Name

Type

Required

Description

campaign_schedule

object

Required

When the campaign may send. Give a schedules array with one or more windows; each window has a name, timing.from and timing.to in 24-hour HH:MM, a days object whose keys "0" to "6" are days of the week set to true or false, and a timezone. Instantly accepts only its own list of timezone names (for example America/Chicago, America/Detroit, Europe/Helsinki, Asia/Kolkata, Australia/Melbourne); America/New_York and UTC are not on that list. Optional start_date and end_date are YYYY-MM-DD in the campaign's timezone. Example: {"schedules": [{"name": "Weekdays", "timing": {"from": "09:00", "to": "17:00"}, "days": {"0": true, "1": true, "2": true, "3": true, "4": true, "5": false, "6": false}, "timezone": "America/Chicago"}], "start_date": "2026-11-01"}.

name

string

Required

Name of the campaign. Example: "Q4 SaaS founders".

allow_risky_contacts

boolean

Optional

Set true to send to leads whose email verified as risky. Example: false.

bcc_list

array

Optional

Email addresses to BCC on every campaign email. Example: ["crm@acme.com"].

cc_list

array

Optional

Email addresses to CC on every campaign email. Example: ["manager@acme.com"].

daily_limit

number

Optional

Maximum emails the campaign sends per day across all accounts. Example: 50.

daily_max_leads

integer

Optional

Maximum new leads the campaign contacts per day. Example: 20.

disable_bounce_protect

boolean

Optional

Set true to turn off Instantly's bounce protection for this campaign. Example: false.

email_gap

number

Optional

Minutes to wait between emails sent by the campaign. Example: 10.

email_list

array

Optional

Sending account email addresses to send this campaign from. They must be accounts connected to the workspace (see instantly_accounts_list). Example: ["john@acme-mail.com", "jane@acme-mail.com"].

email_tag_list

array

Optional

Account tag IDs; every sending account with one of these tags is used. Get tag IDs from instantly_custom_tags_list. Example: ["0199a4b2-b16d-7f8c-8e75-901234567890"].

first_email_text_only

boolean

Optional

Set true to send only the first email of the sequence as plain text. Example: true.

insert_unsubscribe_header

boolean

Optional

Set true to add a List-Unsubscribe header to emails. Example: true.

is_evergreen

boolean

Optional

Set true to make the campaign evergreen so it keeps accepting and sending to new leads. Example: false.

link_tracking

boolean

Optional

Set true to track link clicks. Example: false.

match_lead_esp

boolean

Optional

Set true to match each lead with a sending account on the same email provider (Google to Google, Microsoft to Microsoft). Example: false.

open_tracking

boolean

Optional

Set true to track email opens. Example: false.

owned_by

string

Optional

User ID of the campaign owner. Example: "0199a4b2-e49a-7cbf-9ba8-234567890123".

pl_value

number

Optional

Value assigned to each positive lead, used in analytics. Example: 500.

prioritize_new_leads

boolean

Optional

Set true to contact new leads before follow-ups. Example: false.

random_wait_max

number

Optional

Upper bound, in minutes, of a random extra wait added between emails. Example: 5.

sequences

array

Optional

The email copy, as an array with exactly one sequence object (Instantly uses only the first). The sequence has a steps array; each step has type "email", a delay before the next step (delay_unit minutes, hours or days; days by default) and a variants array of one or more {subject, body} emails for A/B testing. Bodies are HTML; use <br/> for line breaks and {{firstName}}-style variables for personalization. Set v_disabled true on a variant to switch it off. Example: [{"steps": [{"type": "email", "delay": 2, "delay_unit": "days", "variants": [{"subject": "Quick question, {{firstName}}", "body": "Hi {{firstName}},<br/><br/>Are you the right person to talk to about outbound?"}]}, {"type": "email", "delay": 3, "variants": [{"subject": "Re: Quick question", "body": "Just following up."}]}]}].

stop_for_company

boolean

Optional

Set true to stop the campaign for every lead at the same company domain when one lead replies. Example: false.

stop_on_auto_reply

boolean

Optional

Set true to also stop when the reply is an automatic reply such as out of office. Example: false.

stop_on_reply

boolean

Optional

Set true to stop sending to a lead once they reply. Example: true.

text_only

boolean

Optional

Set true to send every email as plain text. Example: false.

instantly_campaign_sending_status_get

Get campaign sending status

instantly_campaign_variables_add

Add campaign variables

instantly_campaigns_search_by_lead

Campaigns search by lead

instantly_custom_tag_delete

Delete custom tag

instantly_custom_tag_update

Update custom tag

instantly_custom_tags_assign

Assign custom tags

instantly_email_test_send

Send email test

instantly_email_thread_mark_read

Read email thread mark

instantly_emails_list

List emails

List emails in the Instantly Unibox (sent and received), filtered by campaign, list, lead, sending account, thread, read state or date. Returns emails with id, thread_id, from, to, subject, body, timestamps and lead details, plus next_starting_after. This endpoint allows 20 requests per minute. Use instantly_emails_list to read conversations and find an email ID to reply to. Use instantly_email_get for one email.

Parameters

Name

Type

Required

Description

assigned_to

string

Optional

Only emails whose lead is assigned to this user ID. Example: "0199a4b2-e49a-7cbf-9ba8-234567890123".

campaign_id

string

Optional

Only emails from this campaign. Example: "0199a4b2-6c1e-7a3d-9f20-4b5c6d7e8f90".

company_domain

string

Optional

Only emails with leads at this company domain. Example: "acme.com".

eaccount

string

Optional

Only emails sent or received by these sending accounts (comma-separated). Example: "john@acme-mail.com".

email_type

string

Optional

Only this type of email: received, sent or manual. Example: "received". One of: `received`, `sent`, `manual`.

has_reminder

boolean

Optional

Set true for only emails with a reminder. Example: false.

is_unread

boolean

Optional

Set true for only unread emails. Example: true.

latest_of_thread

boolean

Optional

Set true to return only the latest email in each thread. Example: true.

lead

string

Optional

Only emails with this lead email address. Example: "jane@acme.com".

limit

integer

Optional

Number of emails to return per page, from 1 to 100. Example: 25.

list_id

string

Optional

Only emails for leads in this lead list. Example: "0199a4b2-8e3a-7c5f-9b42-6d7e8f901234".

marked_as_done

boolean

Optional

Set true for only emails marked as done. Example: false.

max_timestamp_created

string

Optional

Only emails created before this ISO 8601 time. Example: "2026-01-31T23:59:59Z".

min_timestamp_created

string

Optional

Only emails created after this ISO 8601 time. Example: "2026-01-01T00:00:00Z".

mode

string

Optional

Unibox view: emode_focused (primary), emode_others or emode_all. Example: "emode_all". One of: `emode_focused`, `emode_others`, `emode_all`.

preview_only

boolean

Optional

Set true to return a short preview instead of the full body. Example: true.

scheduled_only

boolean

Optional

Set true for only scheduled emails. Example: false.

string

Optional

A lead email address, or "thread:" followed by a thread ID to get one thread. Example: "thread:0199a4b3-06bc-7ed1-9dca-456789012345".

sort_order

string

Optional

Sort by creation time: asc or desc (default desc). Example: "desc". One of: `asc`, `desc`.

starting_after

string

Optional

Pagination cursor. Pass the next_starting_after value from the previous response to get the next page. Leave empty for the first page. Example: "0199a4b2-6c1e-7a3d-9f20-4b5c6d7e8f90".

instantly_emails_unread_count

Count emails unread

instantly_lead_create

Create lead

Create a single lead and optionally add it to a campaign or lead list. Returns the created lead with its id. Use instantly_lead_create for one lead. Use instantly_leads_add to import up to 1000 leads at once.

Parameters

Name

Type

Required

Description

assigned_to

string

Optional

User ID to assign the lead to. Example: "0199a4b2-e49a-7cbf-9ba8-234567890123".

blocklist_id

string

Optional

Block list ID to check the lead against. Leave empty to use the workspace default block list. Example: "0199a4b2-8e3a-7c5f-9b42-6d7e8f901234".

campaign_id

string

Optional

Campaign to add the lead to. Use campaign_id or list_id. Example: "0199a4b2-6c1e-7a3d-9f20-4b5c6d7e8f90".

company_name

string

Optional

Lead's company name. Example: "Acme Inc".

custom_variables

object

Optional

Custom fields for the lead as key-value pairs, usable as {{variable}} in emails. Values should be strings, numbers, booleans or null. The campaign gains these variables for all its leads. Example: {"industry": "SaaS", "seats": 40}.

string

Optional

Lead's email address. Required when adding to a campaign. Example: "jane@acme.com".

first_name

string

Optional

Lead's first name. Example: "Jane".

job_title

string

Optional

Lead's job title. Example: "Head of Sales".

last_name

string

Optional

Lead's last name. Example: "Doe".

list_id

string

Optional

Lead list to add the lead to. Use campaign_id or list_id. Example: "0199a4b2-8e3a-7c5f-9b42-6d7e8f901234".

lt_interest_status

number

Optional

Lead interest status: 1 = Interested, 2 = Meeting Booked, 3 = Meeting Completed, 4 = Won, 0 = Out of Office, -1 = Not Interested, -2 = Wrong Person, -3 = Lost, -4 = No Show. A custom lead label's interest status value also works. Example: 1.

personalization

string

Optional

Personalized opening line for the lead, available as the {{personalization}} variable in emails. Example: "Loved your talk at SaaStr."

phone

string

Optional

Lead's phone number. Example: "+14155550123".

pl_value_lead

string

Optional

Potential deal value of the lead. Example: "1500".

skip_if_in_campaign

boolean

Optional

Set true to skip the lead if it already exists in any campaign. Example: false.

skip_if_in_list

boolean

Optional

Set true to skip the lead if it already exists in any lead list. Example: false.

skip_if_in_workspace

boolean

Optional

Set true to skip the lead if it already exists anywhere in the workspace. Overrides the other skip flags. Example: true.

verify_leads_on_import

boolean

Optional

Set true to verify the email address in a background job after import. Example: false.

website

string

Optional

Lead's website. Example: "https://acme.com".

instantly_lead_get

Get lead

instantly_lead_label_delete

Delete lead label

instantly_lead_label_update

Update lead label

instantly_lead_list_update

Update lead list

instantly_lead_subsequence_remove

Remove lead subsequence

instantly_leads_move

Move leads

Move or copy leads from a campaign or list to another campaign or list, selected by IDs, search or filter. Returns a background job; poll instantly_background_job_get with its id for progress. Use instantly_leads_move to reorganize leads. Use instantly_leads_add to import new leads.

Parameters

Name

Type

Required

Description

assigned_to

string

Optional

User ID to assign the moved leads to. Example: "0199a4b2-e49a-7cbf-9ba8-234567890123".

campaign_id

string

Optional

Only select leads in this campaign. Get the ID from instantly_campaigns_list. Example: "0199a4b2-6c1e-7a3d-9f20-4b5c6d7e8f90".

check_duplicates

boolean

Optional

Set true to skip leads that already exist in the destination. Example: true.

check_duplicates_in_campaigns

boolean

Optional

Set true to also skip leads that exist in other campaigns. Example: false.

contacts

array

Optional

Only move leads with these email addresses. Example: ["jane@acme.com"].

copy_leads

boolean

Optional

Set true to copy the leads instead of moving them. Example: false.

excluded_ids

array

Optional

Lead IDs to leave out. Example: ["0199a4b2-7d2f-7b4e-8a31-5c6d7e8f9012"].

filter

string

Optional

Only select leads in this state, for example FILTER_VAL_CONTACTED, FILTER_LEAD_INTERESTED, FILTER_VAL_BOUNCED or FILTER_VAL_REPLIED. Example: "FILTER_LEAD_INTERESTED". One of: `FILTER_VAL_CONTACTED`, `FILTER_VAL_NOT_CONTACTED`, `FILTER_VAL_COMPLETED`, `FILTER_VAL_UNSUBSCRIBED`, `FILTER_VAL_ACTIVE`, `FILTER_LEAD_INTERESTED`, `FILTER_LEAD_NOT_INTERESTED`, `FILTER_LEAD_MEETING_BOOKED`, `FILTER_LEAD_MEETING_COMPLETED`, `FILTER_LEAD_CLOSED`, `FILTER_LEAD_OUT_OF_OFFICE`, `FILTER_LEAD_WRONG_PERSON`, `FILTER_LEAD_LOST`, `FILTER_LEAD_NO_SHOW`, `FILTER_LEAD_CUSTOM_LABEL_POSITIVE`, `FILTER_LEAD_CUSTOM_LABEL_NEGATIVE`, `FILTER_VAL_BOUNCED`, `FILTER_VAL_SKIPPED`, `FILTER_VAL_RISKY`, `FILTER_VAL_INVALID`, `FILTER_VAL_VALID`, `FILTER_VAL_CATCH_ALL`, `FILTER_VAL_NOT_VERIFIED`, `FILTER_VAL_IN_SUBSEQUENCE`, `FILTER_VAL_OPENED_NO_REPLY`, `FILTER_VAL_COMPLETED_NO_REPLY`, `FILTER_VAL_NO_OPENS`, `FILTER_VAL_REPLIED`, `FILTER_VAL_LINK_CLICKED`.

ids

array

Optional

Specific lead IDs to select. Provide campaign_id or list_id together with this. Example: ["0199a4b2-7d2f-7b4e-8a31-5c6d7e8f9012"].

limit

number

Optional

Maximum number of leads to move. Example: 100.

list_id

string

Optional

Only select leads in this lead list. Get the ID from instantly_lead_lists_list. Example: "0199a4b2-8e3a-7c5f-9b42-6d7e8f901234".

reset_interest_status

boolean

Optional

Set true to reset the leads' interest status in the destination; false keeps it. Example: false.

string

Optional

Only select leads whose name or email matches this text. Example: "acme.com".

skip_invalid_emails

boolean

Optional

Set true to leave behind leads whose email verified as invalid or risky. Example: true.

skip_leads_in_verification

boolean

Optional

Set true to leave behind leads whose email verification is still running. Example: false.

to_campaign_id

string

Optional

Destination campaign. Provide to_campaign_id or to_list_id. Example: "0199a4b2-6c1e-7a3d-9f20-4b5c6d7e8f91".

to_list_id

string

Optional

Destination lead list. Provide to_campaign_id or to_list_id. Example: "0199a4b2-8e3a-7c5f-9b42-6d7e8f901235".

instantly_subsequence_get

Get subsequence

For more tools, view docs.

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// Instantly tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["instantly"], toolNames: [
    "instantly_campaigns_list",
    "instantly_leads_add",
    "instantly_campaign_activate"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "Add these leads to the Q3 Founders campaign and launch it" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["instantly"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Add these leads to the Q3 Founders campaign and launch it" }],
  tools,
});

// Execute the tool call with the user's vaulted Instantly access token
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["instantly"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Add these leads to the Q3 Founders campaign and launch it" }],
  tools,
});

// Tool call runs with the user's vaulted Instantly access token
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["instantly"] }, pageSize: 100,
});

const agent = new Agent({
  name: "outbound_agent",
  model: "gemini-2.5-pro",
  instruction: "Instantly tools scoped to this user",
  tools,
});

await agent.run("Add these leads to the Q3 Founders campaign and launch it");

Try these prompts

Copy any prompt into your agent. Each maps directly to a Instantly tool. Click to copy, paste into your agent, done.

Campaigns

Copy the prompt

Copied

Create a campaign called Q3 Founders that sends weekdays from 9am to 5pm.

Copy the prompt

Copied

Pause the Q3 Founders campaign.

Copy the prompt

Copied

Show open and reply rates for each step of the Q3 Founders campaign.

Leads

Copy the prompt

Copied

Add these 40 leads to the Q3 Founders campaign.

Copy the prompt

Copied

Mark jordan@acme.com as Interested.

Copy the prompt

Copied

Find which campaigns contain jordan@acme.com.

Inbox and accounts

Copy the prompt

Copied

List unread emails in the Unibox from today.

Copy the prompt

Copied

Reply to Jordan's email with our calendar link.

Copy the prompt

Copied

Run a vitals check on our sending accounts' DNS records.

SEE HOW AUTH WORKS

Each user connects their own Instantly access token once, and Scalekit sends it with every call. Credentials stay vaulted, every call is scope checked, and every action is logged.

Authorize

Your user connects

Instantly

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

Instantly

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

Instantly

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

Instantly

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other sales and outreach connectors.

GTM and RevOps Teams

Outbound prospecting agent

Searches Apollo for prospects matching your ICP, scores and ranks them, drafts personalized outreach in Gmail, and logs every send to Google Sheets. Mail goes out as the rep, not from a shared inbox.

GTM and RevOps Teams

CRM AI agent

Reads the Granola transcript after every call, extracts next steps and updates the HubSpot record, drafts the follow-up in Gmail, and confirms in Slack, all on the rep's own delegated OAuth.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared Instantly access token looks fine in a demo. In production every campaign launch looks like one service account, and you cannot tell which user triggered it. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared token
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

Instantly today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access Instantly as the user or through a shared token?

As the user. Each user connects their own Instantly access token once, and Scalekit sends it with every call. Campaign changes, lead updates, and replies are attributed to that user in your audit trail, not a shared service account.

Where is the Instantly access token stored?

In Scalekit's managed AES-256 token vault, namespaced per tenant. To rotate it, the user reconnects with a new access token. Revocation is a single dashboard action. Credentials never appear in prompts, logs, or LLM context.

Can I limit what the agent does in Instantly?

Yes. Filter by tool name in listScopedTools to expose only what you want, for example campaign and lead tools without instantly_campaign_delete or instantly_leads_delete. Scalekit also enforces scope checks before every API call.

What happens when a user revokes Instantly access?

The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Can the agent tell why an Instantly campaign is not sending?

Yes. instantly_campaign_sending_status_get explains why a campaign is not sending or is sending slower than expected, and instantly_accounts_vitals_test checks DNS records such as SPF, DKIM, DMARC and MX on sending accounts.