instantly-automation
π―SkillInstallation
npx skills add composiohq/awesome-claude-skills --skill instantly-automationRun it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).
Uses skills.sh Β· Node.js 22.20+
After installing
Ask for related work and the agent uses it on its own, or call it yourself.
/Instantly AutomationInstall by hand
Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.
Open the skill folder β- This project
.claude/skills/instantly-automation/ - All projects
~/.claude/skills/instantly-automation/
These paths are for Claude Code. For other tools, the command above puts it in the right place.
SKILL.md
View on GitHub βAutomate Instantly cold email outreach -- manage campaigns, sending accounts, lead lists, bulk lead imports, and campaign analytics -- using natural language through the Composio MCP integration.
Instantly Automation
Automate your cold email outreach with Instantly -- create and manage campaigns with multi-step sequences, configure sending schedules, import leads in bulk, manage sending accounts, and track campaign performance -- all through natural language commands.
Toolkit docs: composio.dev/toolkits/instantly
Setup
- Add the Composio MCP server to your client configuration:
https://rube.app/mcp - Connect your Instantly account when prompted (API key authentication).
- Start issuing natural language commands to manage your outreach campaigns.
Core Workflows
1. List Sending Accounts
Retrieve all email accounts configured in your Instantly workspace, with filtering by status and provider.
Tool: INSTANTLY_LIST_ACCOUNTS
Example prompt:
"Show all active sending accounts in my Instantly workspace"
Key parameters:
status-- Filter by status:1(Active),2(Paused),-1(Connection Error),-2(Soft Bounce Error),-3(Sending Error)provider_code-- Filter by provider:1(Custom IMAP/SMTP),2(Google),3(Microsoft),4(AWS)search-- Search by email substring or domainlimit-- Max items (1-100)starting_after-- Pagination cursor from previous responsetag_ids-- Comma-separated tag UUIDs
2. Create a Campaign
Launch a new outreach campaign with scheduling, email sequences, A/B testing variants, and sending configuration.
Tool: INSTANTLY_CREATE_CAMPAIGN
Example prompt:
"Create an Instantly campaign called 'Q1 Outreach' that sends Monday-Friday 9am-5pm Central time with a 3-step email sequence"
Key parameters:
name(required) -- Campaign namecampaign_schedule(required) -- Schedule configuration:schedules(required) -- Array of schedule objects, each with:name-- Schedule nametiming--{from: "09:00", to: "17:00"}(HH:mm format)days-- Map of day index strings "0" (Sun) to "6" (Sat) to booleanstimezone-- Supported values include "America/Chicago", "America/Detroit", "America/Boise", "America/Anchorage"
start_date/end_date-- ISO 8601 dates
email_list-- Array of sending account email addresses (must be pre-configured accounts; useINSTANTLY_LIST_ACCOUNTSto discover valid addresses)sequences-- Array (only first element used) containing:steps-- Array of step objects with:type-- Must be "email"delay-- Days before NEXT email (integer, min 0)variants-- Array of{subject, body}objects for A/B testing
daily_limit-- Daily sending capemail_gap-- Minutes between emailsstop_on_reply-- Stop campaign when lead replies (boolean)stop_on_auto_reply-- Stop on auto-replies (boolean)open_tracking/link_tracking-- Enable tracking (booleans)
Timezone notes:
- Verified working: "America/Chicago" (Central), "America/Detroit" (Eastern), "America/Boise" (Mountain)
- Auto-mapped: "America/New_York" maps to "America/Detroit", "America/Denver" maps to "America/Boise"
- NOT supported: "America/Los_Angeles", "US/Pacific" -- use "America/Anchorage" or "America/Dawson" as alternatives
3. Update Campaign Settings
Modify an existing campaign's schedule, sending limits, sequences, or tracking settings.
Tool: INSTANTLY_UPDATE_CAMPAIGN
Example prompt:
"Update my Instantly campaign to increase the daily limit to 100 and enable open tracking"
Key parameters:
id(required) -- Campaign UUID- Any combination of:
name,campaign_schedule,email_list,sequences,daily_limit,email_gap,stop_on_reply,open_tracking,link_tracking, etc. - Set any parameter to
nullto unset it
4. Manage Lead Lists and Bulk Import
Create dedicated lead lists and import prospects in bulk for campaign targeting.
Tools: INSTANTLY_CREATE_LEAD_LIST, INSTANTLY_ADD_LEADS_BULK
Example prompt:
"Create a lead list called 'Q1 Prospects' and add 50 leads to my Instantly campaign"
Key parameters for creating lead lists:
- List name and configuration
Key parameters for bulk lead import:
- Campaign or list ID to import into
- Array of lead objects with email and metadata
- Duplicate handling options
- Lead verification settings
5. Review Campaign Details
Retrieve full campaign configuration to verify settings, inspect sequences, or prepare for updates.
Tool: INSTANTLY_GET_CAMPAIGN
Example prompt:
"Show me the full details of my Instantly campaign"
Key parameters:
id(required) -- Campaign UUID
6. List All Campaigns
Enumerate all campaigns in your workspace with optional filters and pagination.
Tool: INSTANTLY_LIST_CAMPAIGNS
Example prompt:
"List all my Instantly campaigns"
Key parameters:
- Optional filters and pagination parameters
Known Pitfalls
- Timezone support is limited: The Instantly API accepts a restricted set of timezone strings. Pacific Time ("America/Los_Angeles") is NOT supported. Use "America/Anchorage" (UTC-9/UTC-8) or "America/Dawson" (UTC-7 year-round) as alternatives.
- Invalid schedule payloads cause 400 errors: A malformed
campaign_schedule(missingdays,from,to, orschedules) triggers HTTP 400. Repeated 400s indicate payload issues, not transient failures. - Sequences must be complete: Each sequence step requires a valid
type("email"),delay, and at least one variant with bothsubjectandbody. Incomplete variants block campaign creation. - Only first sequence element is used: The API only processes
sequences[0]. Additional sequences are ignored. - email_list must reference existing accounts: The
email_listfield requires email addresses of pre-configured sending accounts in your Instantly workspace, not arbitrary recipient addresses. Always useINSTANTLY_LIST_ACCOUNTSto discover valid sending addresses. - 401 scope errors on campaign creation: Campaign creation can fail with "Invalid scope. Required: campaigns:create". Update your API key permissions before retrying writes.
- Read-back fields may differ: Field names in
INSTANTLY_GET_CAMPAIGNresponses may differ from create payloads (e.g.,timing.from_vstiming.from). Parse defensively.
Quick Reference
| Action | Tool Slug | Required Params |
|---|---|---|
| List sending accounts | INSTANTLY_LIST_ACCOUNTS | None (optional filters) |
| Create campaign | INSTANTLY_CREATE_CAMPAIGN | name, campaign_schedule |
| Update campaign | INSTANTLY_UPDATE_CAMPAIGN | id |
| Get campaign details | INSTANTLY_GET_CAMPAIGN | id |
| List campaigns | INSTANTLY_LIST_CAMPAIGNS | None (optional filters) |
| Create lead list | INSTANTLY_CREATE_LEAD_LIST | List name |
| Bulk import leads | INSTANTLY_ADD_LEADS_BULK | Campaign/list ID, leads |
Powered by Composio
More from this repository10
A Claude Code plugin that analyzes meeting notes and transcripts to extract key insights, action items, and decisions using Composio app integrations.
A Claude Code plugin from the Awesome Claude Skills collection that downloads videos from YouTube and other platforms for offline viewing, editing, or archival, with support for various formats and quality options.
A Claude Code plugin that assists in writing high-quality content by conducting research, adding citations, improving hooks, and providing section-by-section feedback.
A Claude Code plugin that automatically organizes and categorizes files in your workspace using Composio integrations, helping maintain a clean project structure.
A Claude Code plugin providing tools for creating elaborate, multi-component HTML artifacts using React, Tailwind CSS, and shadcn/ui in claude.ai.
A Claude Code skill that randomly selects winners from participant lists, spreadsheets, or Google Sheets for giveaways and contests using cryptographically secure randomness.
A Claude Code plugin that automates Zoho CRM workflows including lead management, contact updates, deal tracking, account operations, and custom module interactions through Composio integration.
A Claude Code plugin that enforces brand consistency by checking code and content against your brand guidelines using Composio integrations.
A pre-built workflow skill for automating Help Scout via Composio, enabling Claude to manage conversations, customers, mailboxes, and tags through structured tool sequences and parameter guidance.
A Claude Code plugin that automatically creates user-facing changelogs from git commits by analyzing commit history and transforming technical commits into customer-friendly release notes.