Skip to main content
Leadsforge logo
  • Category: ai sales tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 32
  • Triggers: 0
  • Slug: LEADSFORGE
  • Version: 00000000_00

Tools

Slug: LEADSFORGE_COUNT_LEADSCount people matching Leadsforge person and company filters without returning lead records. Charge behavior is undocumented; do not assume this action is free. Authenticated behavior has not been live-verified.

Input Parameters

object
Leadsforge person IDs to include or exclude.
object
Leadsforge company IDs to include or exclude.
object
Lead tenure bounds.
object
Company name terms to include or exclude.
object
Exact company-type values to include or exclude.
object
Company niche terms to include or exclude.
array
Email addresses to exclude from the count.
object
Languages to include or exclude and whether to match only the primary language.
object
Canonical lead-location tokens to include or exclude.
object
Company domains to include or exclude.
array
Company domains to exclude from the count.
object
Job-title terms to include or exclude, with optional exact matching.
object
Company keywords with optional all-values matching.
boolean
Whether every matching lead must have a company.
object
Exact lead department values to include or exclude.
object
Exact seniority values to include or exclude.
object
Company location terms to include or exclude.
object
Exact case-sensitive industry values to include or exclude.
object
Technologies where any and/or all listed values should match.
array
LinkedIn profile URLs to exclude from the count.
object
Funding-round values to include or exclude.
array
Exact provider revenue-category values to match.
object
Business-model values to include or exclude.
integer
Maximum contacts counted per company (0-100).
object
Company founding-year bounds.
object
Company employee-count bounds.
object
Company age-in-years bounds.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_FIND_MOBILE_PHONEFind one person’s mobile phone number synchronously using a Leadsforge person ID, LinkedIn URL, or name plus a company signal. The result contains sensitive personal contact data and is discovery, not phone verification. A successful hit costs 10 credits; a miss is documented free. Retries may repeat a charged lookup because provider deduplication is undocumented.

Input Parameters

string
Company name for a name-based lookup when a domain is unavailable.
string
Person’s last name; use with first_name and a company signal.
string
Leadsforge person ID returned by Search Leads.
string
Person’s first name; use with last_name and a company signal.
string
Caller correlation value echoed in the response; maximum 128 characters.
string
Person’s LinkedIn profile URL.
string
Preferred company identity signal for a name-based lookup.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_FIND_WORK_EMAILFind one person’s work email synchronously from a Leadsforge person ID, LinkedIn URL, or full name plus a company signal. The result contains sensitive personal data. Leadsforge documents a cost of 1 credit when an email is found and no charge on a miss. This performs discovery, not email verification. Retry charging or deduplication is undocumented, so avoid automatic retries.

Input Parameters

string
Company name for a name-based lookup when a domain is unavailable.
string
Person’s last name; use with first_name and a company signal.
string
Leadsforge person ID returned by Search Leads.
string
Person’s first name; use with last_name and a company signal.
string
Caller correlation value, up to 128 characters, echoed in the response.
string
Person’s LinkedIn profile URL.
string
Preferred company identity signal for a name-based lookup.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_GET_BALANCEReturn available and reserved credits plus current enrichment and company-discovery prices. Use this non-mutating read as a safe credential check. Leadsforge does not document a per-call charge for this endpoint, but that does not establish that it is free.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_GET_COMPANY_FOLLOWER_FILTER_VALUESReturn supported countries, departments, seniority levels, or states accepted by START_COMPANY_FOLLOWER_SEARCH. These static reads are not documented as charged. Select one filter family per call.

Input Parameters

string ("countries" | "departments" | "levels" | "states")
required
Static company-follower filter family to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_GET_COMPANY_FOLLOWER_JOBGet one company-follower job’s status, progress, company context, credit accounting, result path, and webhook metadata. This reads one snapshot and does not poll; call it again later while status is in_progress, then use List Company Follower Results. This read is not documented as charged, but is not represented as free.

Input Parameters

string
required
Company-follower job ID returned by Start Company Follower Search or List Company Follower Jobs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_GET_ENRICHMENT_JOBGet the current status, progress, credit accounting, result URL, and webhook metadata for one asynchronous enrichment job. This reads one snapshot and does not poll; call it again later while the job remains in progress, then use List Enrichment Results when it completes.

Input Parameters

string
required
Enrichment job ID returned by a bulk discovery action or List Enrichment Jobs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_GET_LOOKALIKE_FILTER_VALUESReturn controlled departments, employee ranges, locations, or seniorities accepted by Leadsforge company lookalike preview and search.

Input Parameters

string ("departments" | "employee_ranges" | "locations" | "seniorities")
required
Lookalike filter-value family to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_GET_MAPS_CATEGORIESReturn Leadsforge’s curated Google Maps business categories recommended for Start Maps Business Search. The start action also accepts free-text categories. This read is not documented as charged, but is not represented as free.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_GET_MAPS_OWNER_JOBGet one snapshot of a Maps owner-enrichment job’s lifecycle status, business progress, owner count, credit accounting, acceptance outcomes, result and status URLs, and webhook metadata. This does not poll. Keep checking while status is in_progress, then use List Maps Owner Results. A completed job can still contain an error when contact backfill stopped early because credits ran out. Status reads are not documented as charged, but are not represented as free.

Input Parameters

string
required
Maps owner job ID returned by Start Maps Owner Enrichment or recovery.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_GET_MAPS_SEARCH_JOBGet one local-business Maps search job’s current status, search inputs, found count, credit accounting, result and status URLs, and webhook metadata. This reads one snapshot and does not poll automatically.

Input Parameters

string
required
Maps search job ID returned by start or recovery.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_GET_SEARCH_FILTER_VALUESReturn the exact controlled values accepted by SEARCH_LEADS for company types, departments, funding types, revenue ranges, or seniorities. Industries use the separate searchable and paginated industry-values action.

Input Parameters

string ("company_types" | "departments" | "funding_types" | "revenue_ranges" | "seniorities")
required
Controlled-value family to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_LIST_COMPANY_FOLLOWER_JOBSList and recover company-follower jobs, newest first, with optional lifecycle status, client request ID, and RFC3339 time filters. Use this when a Start Company Follower Search job ID is unknown. Returns one native offset page; advance offset explicitly. This read is not documented as charged, but is not represented as free.

Input Parameters

integer
required
Number of jobs to return. The documented maximum is 100; no minimum is documented.
integer
Native job offset. Leadsforge documents no minimum value.
string ("in_progress" | "completed" | "failed" | "no_results")
Filter by company-follower job lifecycle status.
string
Created-at upper bound in RFC3339 format.
string
Inclusive created-at lower bound in RFC3339 format.
string
Filter by the caller-supplied correlation ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_LIST_COMPANY_FOLLOWER_RESULTSReturn one native offset-controlled page of sensitive LinkedIn follower profiles for a company-follower job. Handle and disclose personal profile data appropriately. Advance offset explicitly using the returned page; no cursor, page-size bound, or default is invented. This read is not documented as charged, but is not represented as free.

Input Parameters

integer
Native page size. Leadsforge documents no default or numeric bound for this endpoint.
string
required
Company-follower job ID.
integer
Native result offset. Leadsforge documents no minimum value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_LIST_ENRICHMENT_JOBSList and recover enrichment jobs, newest first, with optional lifecycle status, channel, client request ID, and RFC3339 time filters. Use this when a bulk email, phone, or LinkedIn job ID is unknown. Pagination uses the provider’s native offset and required limit parameters.

Input Parameters

integer
required
Number of jobs to return. The documented maximum is 100; no minimum is documented.
integer
Native job offset. Leadsforge documents no minimum value.
string ("in_progress" | "completed" | "failed")
Filter jobs by lifecycle status.
string ("email" | "phone" | "linkedin")
Filter by email, phone, or LinkedIn enrichment channel.
string
Created-at upper bound in RFC3339 format.
string
Inclusive created-at lower bound in RFC3339 format.
string
Filter by the caller-supplied clientRequestID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_LIST_ENRICHMENT_RESULTSReturn one native offset-controlled page of results for an enrichment job. The response can contain sensitive personal and contact data, including channel-specific fields in payload; handle and disclose it appropriately. Supply the returned offset plus the number of results as the next offset when more results remain. Reading results is not documented as charged, but is not represented as free.

Input Parameters

integer
required
Number of results to return. The provider requires this value but documents no numeric bound.
string
required
Completed or in-progress enrichment job ID.
integer
Native result offset. The provider documents no minimum.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_LIST_MAPS_OWNER_JOBSList and recover Maps owner-enrichment jobs, newest first, using optional status, client request ID, and RFC3339 time filters. This returns one native offset page and does not poll or fetch additional pages. Recovery reads are not documented as charged, but are not represented as free.

Input Parameters

integer
required
Number of owner jobs to return. The documented maximum is 100.
integer
Native job offset. Leadsforge documents no minimum.
string ("in_progress" | "completed" | "failed" | "no_results")
Filter owner jobs by lifecycle status.
string
Created-at upper bound in RFC3339 format.
string
Inclusive created-at lower bound in RFC3339 format.
string
Filter by the caller-supplied correlation ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_LIST_MAPS_OWNER_RESULTSReturn one native offset page of sensitive owner and contact records for a Maps owner-enrichment job. Results can be read while processing continues; email and phone statuses settle only after the job completes. Handle and disclose returned personal data appropriately. Reading results is not documented as charged, but is not represented as free. This action does not automatically fetch additional pages.

Input Parameters

integer
Owner leads to return. Leadsforge defaults to 50 and allows at most 200.
string
required
Maps owner job ID.
integer
Native result offset. Leadsforge documents no bounds.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_LIST_MAPS_SEARCH_JOBSList and recover local-business Maps search jobs, newest first, using status, client request ID, and RFC3339 time filters. Returns one native offset/limit page; use offset and total to request later pages.

Input Parameters

integer
required
Number of jobs to return, maximum 100. No minimum is documented.
integer
Native job offset. Leadsforge documents no minimum.
string ("in_progress" | "completed" | "failed" | "no_results")
Filter by Maps search-job status.
string
Created-at upper bound in RFC3339 format.
string
Inclusive created-at lower bound in RFC3339 format.
string
Filter by the caller-supplied correlation ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_LIST_MAPS_SEARCH_RESULTSReturn one native offset/limit page of public business records found by a Maps search, including business addresses, domains, and public business phone numbers. The provider classifies this business-discovery response as not sensitive personal data. Pages are readable while the job runs and are complete only after job completion; do not assume an in-progress total is final or auto-fetch all pages.

Input Parameters

integer
Businesses per page. Provider default 50 and maximum 200; no minimum is documented.
string
required
Maps search job ID.
integer
Native result offset, maximum 5000. No minimum is documented.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_PREVIEW_LOOKALIKE_COMPANIESReturn a documented free, uncharged preview of companies similar to 1-10 source domains, optionally filtered by categories, employee ranges, funding stages, and typed locations. Returns companies only, not people.

Input Parameters

array
required
Source company domains (1-10).
array
Typed location IDs from GET_LOOKALIKE_FILTER_VALUES.
array
Optional category filters.
array
Optional funding-stage filters.
array
Employee-range values from GET_LOOKALIKE_FILTER_VALUES.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_SEARCH_COMPANY_FOLLOWER_JOB_TITLESSearch one native page of supported job-title values accepted by START_COMPANY_FOLLOWER_SEARCH. Supply page and page_size to fetch another page; this action does not automatically fetch additional pages.

Input Parameters

integer
Native page number, starting at 1.
Optional job-title search text.
integer
Job-title values to return per page (1-20).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_SEARCH_INDUSTRY_VALUESSearch and page the exact case-sensitive industry values accepted by SEARCH_LEADS.company_industries. Use the native offset and limit fields to request additional pages.

Input Parameters

integer
required
Number of industry values to return (1-100).
integer
Native result offset. The provider documents no minimum.
string
Optional text used to search industry values.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_SEARCH_LEADSSearch people with Leadsforge person and company filters and return one cursor-controlled page of lead identities, roles, LinkedIn URLs, locations, company data, and filter warnings. Results contain sensitive personal data. Charge behavior is undocumented and authenticated behavior is unverified.

Input Parameters

integer
Maximum leads in this page (1-2000).
string
Provider cursor returned by a previous Search Leads call. Pass it unchanged; omit it for the first page. A 410 means the cursor expired, is invalid, or the maximum result count was reached.
object
Leadsforge person IDs to include or exclude.
object
Leadsforge company IDs to include or exclude.
object
Lead tenure bounds.
object
Company name terms to include or exclude.
object
Exact company-type values to include or exclude.
object
Company niche terms to include or exclude.
array
Email addresses to exclude from the search results.
object
Languages to include or exclude and whether to match only the primary language.
object
Canonical lead-location tokens to include or exclude; normalize uncertain input first.
object
Company domains to include or exclude; returned lookalike domains can be used here.
array
Company domains to exclude from the search results.
object
Job-title terms to include or exclude, with optional exact matching.
object
Company keywords with optional all-values matching.
boolean
Whether every returned lead must have a company.
object
Exact lead department values to include or exclude.
object
Exact seniority values to include or exclude.
object
Company location terms to include or exclude.
object
Exact case-sensitive industry values to include or exclude.
object
Technologies where any and/or all listed values should match.
array
LinkedIn profile URLs to exclude from the search results.
object
Funding types to include or exclude; discover exact values first.
array
Exact provider revenue categories from Get Search Filter Values.
object
Business-model values to include or exclude.
integer
Maximum contacts returned per company (0-100).
object
Company founding-year bounds.
object
Company employee-count bounds.
object
Company age-in-years bounds.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_SEARCH_LOOKALIKE_COMPANIESRun a billable paged search for companies similar to 1-10 source domains. This costs 1 credit per company returned; credits are reserved before the search and settled against actual results. Use Preview Lookalike Companies first. Supply page and page_size to fetch one native page; this action does not automatically fetch additional pages.

Input Parameters

integer
Native result page (1-100).
array
required
Source company domains (1-10).
array
Typed location IDs from Get Lookalike Filter Values.
integer
Companies to return per page (1-100).
array
Optional company category filters.
array
Optional company funding-stage filters.
array
Employee-range values from Get Lookalike Filter Values.
string
Stable key for a true retry. Reusing it returns the original result without charging again; use a new key for a new search.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_START_BULK_EMAIL_DISCOVERYStart a billable asynchronous work-email discovery job for 1-500 unique people or Leadsforge person IDs. The job handles sensitive personal data and may reserve or consume credits. It returns a job ID; follow it with Get Enrichment Job and List Enrichment Results, or recover a lost job with List Enrichment Jobs. Setting save_to_list persists results to a Leadsforge list. An optional webhook receives completion or failure events and may be redelivered for up to 24 hours with a stable delivery ID.

Input Parameters

array
Unique person identity objects (1-500). Mutually exclusive with person_ids. Duplicate identities can cause external IDs to be discarded.
array
Unique Leadsforge person IDs from Search Leads (1-500). Mutually exclusive with people.
string
Optional completion or failure webhook URL. Leadsforge may retry failed delivery for up to 24 hours.
boolean
Whether Leadsforge should save the discovered email results to a list.
string
Stable key for retrying the same billable job request without intentionally creating another job. Use a new key for a new job.
string
Caller job-correlation ID that can be used to recover the job later.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_START_BULK_LINKEDIN_DISCOVERYStart a billable asynchronous LinkedIn-profile discovery job for 1-500 unique people or Leadsforge person IDs. The job handles sensitive personal data and may reserve or consume credits. It returns a job ID; follow it with Get Enrichment Job and List Enrichment Results, or recover a lost job with List Enrichment Jobs. Setting save_to_list persists discovered profiles to a Leadsforge list. An optional webhook receives completion or failure events and may be redelivered for up to 24 hours with a stable delivery ID.

Input Parameters

array
Unique person identity objects (1-500). Mutually exclusive with person_ids. Duplicate identities can cause external IDs to be discarded.
array
Unique Leadsforge person IDs from Search Leads (1-500). Mutually exclusive with people.
string
Optional completion or failure webhook URL. Leadsforge may retry failed delivery for up to 24 hours.
boolean
Whether Leadsforge should save the discovered LinkedIn profiles to a list.
string
Stable key for retrying the same billable job request without intentionally creating another job. Use a new key for a new job.
string
Caller job-correlation ID that can be used to recover the job later.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_START_BULK_PHONE_DISCOVERYStart a billable asynchronous phone-number discovery job for 1-500 unique people or Leadsforge person IDs. The job handles sensitive personal data and may reserve or consume credits. It returns a job ID; follow it with Get Enrichment Job and List Enrichment Results, or recover a lost job with List Enrichment Jobs. Setting save_to_list persists results to a Leadsforge list. An optional webhook receives completion or failure events and may be redelivered for up to 24 hours with a stable delivery ID.

Input Parameters

array
Unique person identity objects (1-500). Mutually exclusive with person_ids. Duplicate identities can cause external IDs to be discarded.
array
Unique Leadsforge person IDs from Search Leads (1-500). Mutually exclusive with people.
string
Optional completion or failure webhook URL. Leadsforge may retry failed delivery for up to 24 hours.
boolean
Whether Leadsforge should save the discovered phone results to a list.
string
Stable key for retrying the same billable job request without intentionally creating another job. Use a new key for a new job.
string
Caller job-correlation ID that can be used to recover the job later.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_START_COMPANY_FOLLOWER_SEARCHStart a billable asynchronous search of followers of one LinkedIn company page, optionally filtered by supported geography, department, title, and seniority values. The job handles sensitive personal data and reserves or may consume company-follower credits; Get Balance reports the current unit price. It returns a job snapshot; follow with Get Company Follower Job and List Company Follower Results, or recover a lost ID with List Company Follower Jobs. An optional webhook receives completion or failure events and may be redelivered for up to 24 hours with a stable delivery ID.

Input Parameters

integer
required
Maximum number of followers to process (1-50000).
array
Supported seniority levels from Get Company Follower Filter Values.
array
Supported state or region values from Get Company Follower Filter Values.
array
Supported country values from Get Company Follower Filter Values.
array
Supported titles from Search Company Follower Job Titles.
array
Supported department values from Get Company Follower Filter Values.
string
Completion or failure webhook URL. Leadsforge POSTs JSON, treats 2xx as success, retries a failed delivery immediately, and may redeliver for up to 24 hours with the same X-Webhook-Delivery-Id. Deduplicate deliveries using that header. The payload omits companyLogoUrl; fetch it with Get Company Follower Job.
string
required
LinkedIn company-page URL whose followers should be searched.
string
Stable key for safely retrying the same billable job request. Reusing it returns the existing account job; use a new key to start a new search.
string
Caller correlation ID that can be used to recover the job later.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_START_MAPS_BUSINESS_SEARCHStart a billable asynchronous Google Maps business search. Leadsforge reserves credits for the requested limit and settles them for businesses found. Every search creates a Leadsforge list named ‘Public API: Local Businesses’. It returns a job ID for Get Maps Search Job, List Maps Search Results, or recovery with List Maps Search Jobs. An optional webhook receives completion or failure events and is retried up to 10 times with exponential backoff until a 2xx response.

Input Parameters

number
Search-center latitude (-90 to 90). Coordinates are not required by Swagger.
number
Search-center longitude (-180 to 180). Coordinates are not required by Swagger.
integer
required
Maximum businesses to find (1-5000), used for credit reservation.
string
Optional language code, maximum 10 characters.
number
required
Search radius in kilometers, maximum 500. No minimum is documented.
array
required
OR-combined business categories (1-100). Curated values from Get Maps Categories and free-text values are accepted.
string
Completion or failure webhook URL. Leadsforge retries delivery up to 10 times with exponential backoff until a 2xx response.
string
Stable key for a true retry; reuse returns the existing job. Use a new key for a logically new search.
string
Caller correlation ID that can be used to recover the search job.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_START_MAPS_OWNER_ENRICHMENTStart billable asynchronous owner discovery for 1-200 businesses from one Maps search job, requesting up to 1-8 owners per business and optional email or phone enrichment. Credits are reserved from the requested upper bound and settled per contact found; no-owner and recently cached businesses are documented as uncharged. This handles sensitive owner contact data, may use the standard contact waterfall, and may POST lifecycle events to webhook_url. Only one owner job per search can be in progress. Follow the returned job with Get Maps Owner Job and List Maps Owner Results, or recover it with List Maps Owner Jobs.

Input Parameters

boolean
Whether to enrich owner email contacts. The provider makes this optional.
boolean
Whether to enrich owner phone contacts. The provider makes this optional.
integer
required
Maximum owners to seek per business (1-8). Leadsforge uses this value when reserving the job’s credit upper bound.
string
Optional URL that receives a completion, failure, or no-results webhook. The provider documents the payload but not a retry count for this operation.
array
required
Business IDs from List Maps Search Results (1-200). Missing or unowned businesses are reported as skipped instead of failing the job.
string
required
Maps search job that owns the selected businesses.
string
Stable key for retrying the same owner job. Reusing the key returns the existing account job; use a new key for a logically new job.
string
Caller correlation ID that can be used to recover the owner job.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LEADSFORGE_SUGGEST_LEAD_LOCATIONSResolve a location string to canonical region-level tokens that match people and can be passed to SEARCH_LEADS.lead_locations.

Input Parameters

integer
Maximum number of suggestions to return. The provider default is 5.
string
required
Location name or misspelled or foreign region text to normalize.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not