get_leads_from_campaign
Retrieve and filter leads from a specific campaign using advanced criteria including status, email verification, company, occupation, and timeline parameters to target relevant prospects.
Instructions
Retrieve leads from a specific campaign with advanced filtering
Supports 7 groups of filters with OR logic within groups and AND logic between groups:
Advanced filters (name, company, occupation, headline)
Status filters (status, connection degree, out of office)
Email verification filters
Current step filter
Selected leads filter
Step change timestamp filter
General search filter
Args: user_id: The ID of the user account_id: The ID of the account (seat) campaign_id: The ID of the campaign search: Search leads by fullName, email, company, headline, etc. filter_by_verified_emails: Filter leads with verified emails filter_by_not_verified_emails: Filter leads without verified emails filter_by_status: Filter by status ([1]=Discovered, [2]=Connection pending, [3]=Connected not replied, [4]=Replied) filter_by_connection_degree: Used with filter_by_status=[4] for additional status filtering ([1]=replied connected, [2,3]=replied not connected) filter_by_current_step: Filter leads on specific campaign steps filter_by_name: Filter leads whose names contain this value filter_by_company: Filter leads whose company contains this value filter_by_occupation: Filter leads whose occupation contains this value filter_by_headline: Filter leads whose headline contains this value filter_by_out_of_office: Filter leads with "Out of office" status filter_by_step_change_timestamp: Filter leads with stepChangeTimestamp greater than this filter_by_selected_leads: Retrieve specific leads by their IDs limit: Number of results to return (default: 30) offset: Pagination offset (default: 0)
Returns: List of leads matching the filter criteria with pagination metadata
Example: get_leads_from_campaign( user_id="123", account_id="456", campaign_id="789", filter_by_status=[4], filter_by_connection_degree=[1], filter_by_verified_emails=True, limit=50 )
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | Yes | ||
| account_id | Yes | ||
| campaign_id | Yes | ||
| search | No | ||
| filter_by_verified_emails | No | ||
| filter_by_not_verified_emails | No | ||
| filter_by_status | No | ||
| filter_by_connection_degree | No | ||
| filter_by_current_step | No | ||
| filter_by_name | No | ||
| filter_by_company | No | ||
| filter_by_occupation | No | ||
| filter_by_headline | No | ||
| filter_by_out_of_office | No | ||
| filter_by_step_change_timestamp | No | ||
| filter_by_selected_leads | No | ||
| limit | No | ||
| offset | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||