Bettercontact connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 Bettercontact actions, such as "Create Lead Finder Search", "Get Enrichment Results" and "Get Lead Finder Results". 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 Bettercontact, with input parameters and output schema.
BETTERCONTACT_CHECK_CREDITS_BALANCETool to check the remaining credits balance for a BetterContact account. Use when you need to verify available credits before making API requests that consume credits.
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
BETTERCONTACT_CREATE_LEAD_FINDER_SEARCHTool to create a new Lead Finder search to discover leads based on company and people criteria. Use when you need to find prospects matching specific job titles, departments, seniority, company size, industry, or technology stack.
Input parameters
Filters to apply when searching for leads. At least one filter must be specified
Optional webhook URL to receive results automatically when the search completes
Maximum number of leads to return in the search results
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
BETTERCONTACT_ENRICH_LEADSTool to create a lead enrichment request for work emails and direct phone numbers. Uses waterfall enrichment across multiple data providers for higher accuracy. Supports batches of 1-100 leads.
Input parameters
Array of leads to enrich. Minimum: 1 lead. Maximum: 100 leads per request.
Webhook URL where enrichment results will be pushed once processing is complete.
Process flow ID to use for enrichment, if subscribed to the process flow add-on.
If true, direct phone number of the contact will be enriched using waterfall enrichment.
If true, work email address of the contact will be enriched using waterfall enrichment.
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
BETTERCONTACT_GET_ENRICHMENT_RESULTSTool to retrieve enrichment results for a specific request ID. Use when you need to check the status and get enriched lead data including email addresses, contact information, and summary statistics for a submitted enrichment request.
Input parameters
The unique identifier for the enrichment request. This ID is returned when you submit an enrichment request.
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
BETTERCONTACT_GET_LEAD_FINDER_RESULTSTool to retrieve results from a submitted Lead Finder search. Returns comprehensive lead and company data including contact information, LinkedIn profiles, job titles, company details, and enrichment data.
Input parameters
The unique identifier of the Lead Finder search request to retrieve results for
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 5 Bettercontact actions on Nagent, including "Create Lead Finder Search", "Get Enrichment Results" and "Get Lead Finder Results". Create Lead Finder Search: Create a new Lead Finder search to discover leads based on company and people criteria. Each action is listed on this page with its input parameters and its output.
Bettercontact 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.
Create Lead Finder Search takes 1 required input: filters. It also takes 2 optional inputs: webhook and max_leads. It returns data, error and successful.