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.
SKILL.md
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.
"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 (missing days, from, to, or schedules) 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 both subject and body. 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_list field requires email addresses of pre-configured sending accounts in your Instantly workspace, not arbitrary recipient addresses. Always use INSTANTLY_LIST_ACCOUNTS to 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_CAMPAIGN responses may differ from create payloads (e.g., timing.from_ vs timing.from). Parse defensively.
