Skip to main content
Instantly is a cold email outreach platform that lets agents automate campaigns, manage leads, track deliverability, and handle inbox communications at scale.

​
Setup

  1. In Agent Studio, go to Tools → Instantly → Connect
  2. Paste your API key from the Instantly dashboard
  3. Save your credentials and confirm the connection is active

​
Available actions

ActionDescription
INSTANTLY_CHECK_EMAIL_VERIFICATION_STATUSChecks the verification status of a submitted email address.
INSTANTLY_COUNT_UNREAD_EMAILSRetrieves the total count of unread emails in your inbox.
INSTANTLY_CREATE_AI_ENRICHMENTCreates an AI enrichment job to enhance leads in a campaign or list with model-generated insights.
INSTANTLY_CREATE_API_KEYGenerates a new API key with specified permission scopes for programmatic access.
INSTANTLY_CREATE_CAMPAIGNCreates a new outreach campaign with scheduling, sequences, and sending configuration.
INSTANTLY_CREATE_INBOX_PLACEMENT_TESTCreates an inbox placement test to measure email deliverability across providers.
INSTANTLY_CREATE_LEADAdds a new individual lead and optionally associates them with a campaign.
INSTANTLY_CREATE_LEAD_LISTCreates a new named lead list for organizing leads before importing them into campaigns.
INSTANTLY_CREATE_WEBHOOKRegisters a new webhook endpoint to receive Instantly event notifications via HTTP callbacks.
INSTANTLY_DELETE_API_KEYDeletes a specific API key by its UUID.
INSTANTLY_DELETE_CAMPAIGNPermanently removes a campaign by its UUID.
INSTANTLY_DELETE_LEADDeletes a specific lead by its UUID.
INSTANTLY_DELETE_LEAD_LISTDeletes a specific lead list by its UUID.
INSTANTLY_DELETE_WEBHOOKRemoves a webhook subscription by its UUID.
INSTANTLY_DISABLE_ACCOUNT_WARMUPStops the email warm-up process for one or more sending accounts.
INSTANTLY_ENABLE_ACCOUNT_WARMUPStarts the email warm-up process for one or more sending accounts to improve deliverability.
INSTANTLY_GET_CAMPAIGNRetrieves full configuration details for a campaign by its UUID.
INSTANTLY_GET_CAMPAIGN_ANALYTICSRetrieves performance metrics for one or multiple campaigns with optional date filters.
INSTANTLY_GET_DAILY_CAMPAIGN_ANALYTICSRetrieves per-day analytics for campaigns within an optional date range.
INSTANTLY_GET_EMAIL_SERVICE_PROVIDER_OPTIONSRetrieves available email service provider options for inbox placement tests.
INSTANTLY_GET_INBOX_PLACEMENT_TESTRetrieves results and details for a specific inbox placement test by ID.
INSTANTLY_GET_LEADRetrieves full metadata for a specific lead by its UUID.
INSTANTLY_GET_LEAD_LISTRetrieves details and metadata for a specific lead list by its UUID.
INSTANTLY_GET_VERIFICATION_STATS_FOR_LEAD_LISTRetrieves summary verification status counts for all leads in a specific lead list.
INSTANTLY_GET_WEBHOOKRetrieves the full configuration of a specific webhook subscription by its UUID.
INSTANTLY_GET_WEBHOOK_EVENTRetrieves details of a specific webhook event by its UUID.
INSTANTLY_LIST_ACCOUNTSLists all email sending accounts for the authenticated user with optional filters.
INSTANTLY_LIST_API_KEYSLists all API keys with optional pagination.
INSTANTLY_LIST_CAMPAIGNSLists all campaigns with optional search, tag filters, and pagination.
INSTANTLY_LIST_CUSTOM_TAGSLists custom tags with optional search and pagination.
INSTANTLY_LIST_DFY_EMAIL_ACCOUNT_ORDERSLists Done-For-You email account orders with pagination.
INSTANTLY_LIST_EMAILSLists emails with optional filters for type, status, campaign, lead, and read state.
INSTANTLY_LIST_INBOX_PLACEMENT_BLACKLIST_AND_SPAM_ASSASSIN_REPORTSLists blacklist and SpamAssassin reports for a specific inbox placement test.
INSTANTLY_LIST_INBOX_PLACEMENT_TESTSLists inbox placement tests with optional status filters and pagination.
INSTANTLY_LIST_LEAD_LISTSLists all lead lists with optional search and enrichment task filters.
INSTANTLY_LIST_LEADSLists leads with optional filters for campaign, list, status, and search query.
INSTANTLY_LIST_THREADSLists email threads aggregated from inbox emails with optional unread filter and pagination.
INSTANTLY_LIST_WEBHOOK_EVENTSLists received webhook events with optional date, success, and search filters.
INSTANTLY_LIST_WEBHOOKSLists configured webhook subscriptions with optional campaign and event type filters.
INSTANTLY_MARK_THREAD_AS_READMarks all emails in a specific thread as read.
INSTANTLY_MERGE_LEADSMerges a source lead into a destination lead, consolidating their data.
INSTANTLY_SEARCH_CAMPAIGNS_BY_LEAD_EMAILSearches for campaigns that contain a specific lead identified by their email address.
INSTANTLY_UPDATE_CAMPAIGNUpdates one or more configuration fields of an existing campaign.
INSTANTLY_UPDATE_LEADUpdates fields such as name, company, phone, or interest status for an existing lead.
INSTANTLY_UPDATE_LEAD_INTEREST_STATUSSets or resets the interest status of a lead by their email address.
INSTANTLY_UPDATE_LEAD_LISTUpdates the name, owner, or enrichment settings of an existing lead list.
INSTANTLY_VERIFY_EMAILInitiates an email deliverability verification and optionally sends results to a webhook.

​
Adding to an agent

  1. Open your agent in Agent Studio → Agent Builder
  2. Go to Tools and enable Instantly
  3. Select only the actions your agent needs
  4. Set auth mode: Shared (agent acts on one account) or Per-user (each end-user connects their own account)

​
Example use cases

Automated lead qualification and follow-up An agent monitors incoming replies via INSTANTLY_LIST_EMAILS, reads each thread, and uses INSTANTLY_UPDATE_LEAD_INTEREST_STATUS to tag leads as Interested or Not Interested, then triggers a follow-up sequence automatically. Campaign performance reporting An agent runs on a schedule to call INSTANTLY_GET_CAMPAIGN_ANALYTICS and INSTANTLY_GET_DAILY_CAMPAIGN_ANALYTICS across all active campaigns, compiling a daily summary of opens, replies, and bounce rates for the sales team. Lead list hygiene before campaign launch Before launching a new campaign, an agent iterates through a lead list using INSTANTLY_VERIFY_EMAIL and INSTANTLY_CHECK_EMAIL_VERIFICATION_STATUS to remove undeliverable addresses, then updates the list with INSTANTLY_UPDATE_LEAD_LIST and imports only verified leads.