Skip to main content

How to set up Instantly

Authentication

Instantly uses API key authentication:
  1. Log in to your Instantly account
  2. Navigate to SettingsAPI
  3. Generate or copy your API key
  4. Paste the API key in Cargo when connecting

Instantly actions

Create lead

Add a new lead to an Instantly campaign. Required fields:
  • Email: Lead’s email address
Optional fields:
  • Campaign: Select campaign to add lead to
  • List: Select lead list to add to
  • Assigned to: Assign to team member
Standard fields:
FieldDescription
first_nameLead’s first name
last_nameLead’s last name
company_nameCompany name
personalizationPersonalization text
phonePhone number
websiteCompany website
Custom variables: Add any custom fields for email personalization. Duplicate handling:
  • Skip if in workspace: Prevent adding duplicates in workspace
  • Skip if in campaign: Prevent adding to same campaign twice
  • Skip if in list: Prevent adding to same list twice

Update lead

Modify an existing lead’s information. Required fields:
  • Lead ID: The lead’s unique identifier
Optional fields: Same as create lead (all standard and custom fields).

Delete lead

Remove a lead from Instantly. Required fields:
  • Lead ID: The lead’s unique identifier

Instantly data models

Fetch leads

Pull all leads from Instantly into Cargo. Features:
  • Syncs all leads from your workspace
  • 30-minute minimum sync interval
  • Unifies contacts by email

Listen events

Receive real-time events from Instantly. Event types:
  • Email sent
  • Email opened
  • Link clicked
  • Reply received
  • Bounced
  • Unsubscribed
Features:
  • Auto-ingests events as they occur
  • Real-time webhook processing

Rate limits

Instantly API has a rate limit of 10 requests per second. Cargo handles rate limiting automatically.

Best practices

  • Use custom variables for personalized outreach
  • Enable duplicate skip options to avoid re-adding leads
  • Leverage events for real-time engagement tracking
  • Assign leads to team members for follow-up
  • Use lead lists for organization