Instantly.ai

Instantly.ai integration (Marketing). Imported from open-connector.

API key4 toolshttps://api.instantly.ai

GET

instantly_ai_list_campaigns

List Instantly campaigns with optional search, tag, and status filters.

/api/v2/campaigns

6 parameters

Param	Type	Required	Description
limit	integer	optional	The number of campaigns to return, from 1 to 100.
starting_after	string	optional	The pagination cursor returned by Instantly.
search	string	optional	Search campaigns by name.
tag_ids	array	optional	Campaign tag IDs to filter by. Instantly receives these as a comma-separated qu…
ai_sales_agent_id	string	optional	Filter campaigns by AI Sales Agent ID.
status	number	optional	Filter campaigns by Instantly campaign status enum value.

GET

instantly_ai_get_campaign

Retrieve one Instantly campaign by ID.

/api/v2/campaigns/{id}

1 parameter

Param	Type	Required	Description
id	string	required	The Instantly campaign ID.

POST

instantly_ai_list_leads

List Instantly leads using JSON filters and cursor pagination.

/api/v2/leads/list

17 parameters

Param	Type	Required	Description
search	string	optional	Search leads by first name, last name, or email.
filter	string	optional	Instantly lead filter value, such as FILTER_VAL_CONTACTED.
campaign	string	optional	Campaign ID to filter leads.
list_id	string	optional	Lead list ID to filter leads.
in_campaign	boolean	optional	Whether to return leads that are in a campaign.
in_list	boolean	optional	Whether to return leads that are in a lead list.
ids	array	optional	Lead IDs to include.
excluded_ids	array	optional	Lead IDs to exclude.
contacts	array	optional	Lead email addresses to include.
limit	integer	optional	The number of leads to return, from 1 to 100.
starting_after	string	optional	The pagination cursor returned by Instantly.
organization_user_ids	array	optional	Organization user IDs to filter leads.
smart_view_id	string	optional	Smart view ID to filter leads.
is_website_visitor	boolean	optional	Whether to return website visitor leads.
distinct_contacts	boolean	optional	Whether to return distinct contacts.
enrichment_status	number	optional	Enrichment status enum value to filter leads.
esg_code	string	optional	ESG code to filter leads.

POST

instantly_ai_create_lead

Create a lead in an Instantly campaign or lead list.

/api/v2/leads

20 parameters

Param	Type	Required	Description
campaign	string	optional	—
list_id	string	optional	—
email	string	optional	—
personalization	string	optional	—
website	string	optional	—
last_name	string	optional	—
first_name	string	optional	—
company_name	string	optional	—
job_title	string	optional	—
phone	string	optional	—
lt_interest_status	number	optional	Lead interest status enum value.
pl_value_lead	string	optional	—
assigned_to	string	optional	—
skip_if_in_workspace	boolean	optional	Whether to skip creation if the lead is already in the workspace.
skip_if_in_campaign	boolean	optional	Whether to skip creation if the lead is already in the campaign.
skip_if_in_list	boolean	optional	Whether to skip creation if the lead is already in the list.
blocklist_id	string	optional	The blocklist ID to check for the lead.
verify_leads_for_lead_finder	boolean	optional	Whether to verify the lead for lead finder.
verify_leads_on_import	boolean	optional	Whether to verify the lead on import.
custom_variables	object	optional	Custom variables for an Instantly lead. Values must be strings, numbers, boolea…