NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
LeadIQ connects to a Nagent workspace with an API key. Once it is connected, agents can call 9 LeadIQ actions, such as "Get Account Details", "Get Contact Tracking Balance" and "Get Usage Statistics". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against LeadIQ, with input parameters and output schema.
LEADIQ_ABANDON_BATCHAbandon a contact tracking import batch that is no longer needed. Use when you need to cancel or stop an ongoing import batch operation.
Input parameters
Optional reason for abandoning the batch. Provide context about why this batch is being abandoned.
The ID of the import batch to abandon. This should be the unique identifier of the contact tracking import batch.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LEADIQ_GET_ACCOUNTRetrieve current user's account information including plans, billing cycles, and credit usage. Use to check available API credits, billing status, and data visibility settings before making data queries.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LEADIQ_GET_CONTACT_TRACKING_BALANCETool to check the remaining balance of contact tracking credits available for the account. Use when you need to verify how many contact tracking credits are left.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LEADIQ_GET_USAGETool to retrieve API usage statistics and credit consumption for the current LeadIQ account. Use when you need to check credit usage, remaining capacity, or billing information.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LEADIQ_SEARCH_COMPANYTool to search for companies by name, domain, LinkedIn URL, or other identifying information. Use when you need to find companies matching specific criteria. Returns detailed company information including employee count, industry, location, and social profiles.
Input parameters
Search criteria for finding companies. At least one search field (name, domain, linkedinId, or linkedinUrl) should be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LEADIQ_SEARCH_GROUPED_ADVANCEDTool to search for people by job title, seniority, role, company size, and location with results grouped by company. Returns companies with matching people nested under each company for account-based prospecting. Use when you need to find contacts at companies matching specific criteria.
Input parameters
Advanced search criteria for grouped results with people nested under companies
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LEADIQ_SEARCH_PEOPLESearch for individual contacts by name, company (past and present), LinkedIn profile, email, or phone number. Use when you need to find people based on identifying information. Returns comprehensive contact data including work/personal emails, phones, employment history, education, and social profiles.
Input parameters
Person identifier to search for a specific person by their LeadIQ ID
Number of results to skip for pagination. Use with limit to paginate through results
Email address to search for a person
Maximum number of results to return. Default and maximum is 100
Phone number to search for a person. Can include country code
Company details for filtering search results.
Full name of the person to search for. Alternative to using firstName and lastName separately
Last name of the person to search for
First name of the person to search for
LinkedIn identifier to search for a person by their LinkedIn ID
Middle name of the person to search for
SHA256 hashed email address for privacy-preserving search
LinkedIn profile URL to search for a person
Minimum confidence score threshold (0-100). Only return results with confidence scores at or above this value. Higher scores indicate more reliable data
Filter results by profile characteristics. Only return people who match at least one of the specified profile types
Phone quality filter values.
Include people with invalid email addresses in results. By default, invalid emails are excluded
Filter results by work email verification status. Only return people whose work email matches one of these statuses
Filter to only return people who have work contact information (work email or work phone). Set to true to require work contacts, false to exclude them, or omit for no filtering
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LEADIQ_SEARCH_PEOPLE_FLATTool to search for people using advanced filters by job title, seniority, role, company size, location, and more. Returns a flat list of individual contacts unorganized by company.
Input parameters
Search criteria including company filters, contact filters, and pagination parameters
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LEADIQ_SUBMIT_PERSON_FEEDBACKTool to submit data correction feedback for person contact information to improve LeadIQ data accuracy. Use when you need to report contact info status, invalid reasons, or update profile details.
Input parameters
Full name of the person.
Contact information type. Specifies whether it's personal or work-related contact info.
Job title of the person.
Contact information - MUST be a valid email address or phone number format (required).
Contact information status. Use 'Correct' if verified working, 'Invalid' if not working.
Timestamp of last verification in ISO 8601 format.
Person identifier in LeadIQ system.
Company identifier in LeadIQ system.
LinkedIn identifier for the person.
Name of the company the person works for.
LinkedIn profile URL of the person.
Company website domain.
Error classification for invalid data. Provide specific reason if status is Invalid (e.g., EmailBounceCode513, WrongNumber).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 9 LeadIQ actions on Nagent, including "Get Account Details", "Get Contact Tracking Balance" and "Get Usage Statistics". Get Account Details: Retrieve current user's account information including plans, billing cycles, and credit usage. Each action is listed on this page with its input parameters and its output.
LeadIQ connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It returns data, error and successful.