get_leads_from_seat
Retrieve and filter leads from a specific account using criteria like name, company, status, email verification, and occupation to find targeted prospects.
Instructions
Retrieve leads from a specific seat (account) with advanced filtering
Supports 6 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
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) 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_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 from the seat matching the filter criteria
Example: get_leads_from_seat( user_id="123", account_id="456", filter_by_company="Acme Corp", filter_by_verified_emails=True, limit=100 )
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | Yes | ||
| account_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_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 |