Skip to main content
LeadMagic logo
  • Category: people & contact data
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 109
  • Triggers: 0
  • Slug: LEADMAGIC
  • Version: 20261101_00
  • Instant: Supported on the latest version. Support varies by tool.

Tools

Slug: LEADMAGIC_ADD_EMAILS_TO_SUPPRESSION_LISTAdd a non-empty plaintext email list to a suppression list created by the workflow, using its lifecycle-owned list ID and addresses. This action is unavailable with managed credentials.

Input Parameters

array
required
Non-empty plaintext email list to add. LeadMagic normalizes and SHA-256 hashes each address server-side; use only lifecycle-owned addresses.
string
required
Exact suppression-list identifier captured from Create Email Suppression List in the same owned lifecycle.

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: LEADMAGIC_CREATE_CREDIT_BUDGETCreate a persistent credit budget for one LeadMagic scope and record its returned ID for later updates or deletion. Managed access is not qualified; use a connected API key.

Input Parameters

string
required
Budget scope type defined by LeadMagic.
string
Budget reset period defined by LeadMagic.
string
Email address that receives budget threshold alerts.
number
required
Maximum credits available to this budget during each period.
string
required
Workspace value to which the budget applies.
number
Fraction of the budget at which an alert is sent, from 0 to 1.

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: LEADMAGIC_CREATE_EMAIL_SUPPRESSION_LISTCreate an owned suppression list from a unique list ID and non-empty plaintext email list; capture the returned ID for later operations and delete the list at the end of its lifecycle. Managed access is not qualified; use a connected API key.

Input Parameters

array
required
Non-empty plaintext email list to suppress. LeadMagic normalizes and SHA-256 hashes each address server-side; use only addresses owned by this workflow.
string
required
Unique identifier for the new suppression list. Use a workflow-specific value that cannot collide with a pre-existing workspace list.

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: LEADMAGIC_CREATE_JOB_SEARCH_EXPORT_V3Synchronously export up to 5,000 matching jobs. At least one search filter is required. The price grows with the number of jobs returned; limit defaults to 1.

Input Parameters

object
Job tag include and exclude filters.
integer
Maximum jobs to return (1-5000). Defaults to 1. The price grows with the number of jobs returned.
object
Normalized annual salary filters.
object
Title include, exclude, and semantic matching filters.
object
Country, region, state, and city filters.
object
Company name, domain, or canonical ID filters.
array
Canonical work-mode IDs to include.
integer
Only return jobs posted within this many days (1-365).
boolean
Include company details for each exported job.
boolean
Include full job descriptions in the export.
object
Occupation taxonomy filters by hierarchy level.

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: LEADMAGIC_DELETE_CREDIT_BUDGETPermanently delete one credit budget using only the ID captured from its creation in the same owned lifecycle. Managed access is not qualified; use a connected API key.

Input Parameters

string
required
Exact credit-budget identifier captured when this workflow created the budget. Never use an ID selected from pre-existing workspace budgets.

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: LEADMAGIC_DELETE_EMAIL_SUPPRESSION_LISTPermanently delete an entire suppression list and its stored hashes using only the list ID captured from its creation in the same owned lifecycle. Managed access is not qualified; use a connected API key.

Input Parameters

string
required
Exact suppression-list identifier captured from Create Email Suppression List in the same owned lifecycle. Never use an ID discovered by listing.

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: LEADMAGIC_DETECT_JOB_CHANGECheck whether a person has changed jobs relative to an expected company; a resolved check costs 3 credits and PROFILE_NOT_FOUND is free. Managed access is not qualified; use a connected API key.

Input Parameters

string
required
Professional profile URL or identifier for the person to check.
string
Expected current company name. Provide this or company_domain.
string
Expected current company domain. Provide this or company_name.

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: LEADMAGIC_DOWNLOAD_BULK_JOB_RESULTS_CSVDownload result rows for an owned bulk job as an offloaded CSV using a job ID from the same submission chain; downloads exceeding 50 MiB fail. Managed access is not qualified; use a connected API key.

Input Parameters

string
required
UUID captured from a bulk job created by this workflow.

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: LEADMAGIC_ENRICH_COMPANY_V1Call POST /v1/companies/company-search to enrich one company from its domain, name, or business profile identifier. A found company costs 1 credit.Instant: Supported on the latest version.Instant pricing: $0.020 per company enrichedDiscount: 57

Input Parameters

string
Business company profile URL or identifier.
string
Company name when its domain or profile URL is unavailable.
string
Company domain, such as example.com.

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: LEADMAGIC_ENRICH_COMPANY_V3_DOCS_ALIASSearch or look up companies through the /v3/companies/enrich compatibility route and return one cursor-controlled page. Prefer SEARCH_COMPANIES for new integrations. This action is unavailable with managed credentials.

Input Parameters

integer
Maximum companies on this page (1-50). This does not fetch later pages.
string
Free-text company search query.
string
Opaque next_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
string
Documented alias for company_domain.
integer
Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
string
Company website URL or domain.
string
Professional company profile URL.
string
Company name to look up or search.
string
Documented alias for a professional company profile URL.
string
Direct one-company lookup domain, such as example.com.
object
Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.

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: LEADMAGIC_FIND_COMPANY_COMPETITORS_V1Find competitors from a company domain, profile, or name. A found competitor list costs 5 credits.

Input Parameters

string
Business company profile URL or identifier.
string
Company name.
string
Company website domain.

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: LEADMAGIC_FIND_COMPANY_EMPLOYEES_V1Find up to 10 employees at one company, including names, titles, locations and professional profile URLs; each returned employee costs up to 1 credit. Managed access is not qualified; use a connected API key.

Input Parameters

integer
Maximum employees to return (1-10). Each returned employee costs up to 1 credit; use 1 for the lowest price.
string
Company name when its domain is unavailable. Provide this or company_domain.
string
Company website domain, preferred when known. Provide this or company_name.

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: LEADMAGIC_FIND_JOBS_V1Find jobs with LeadMagic V1 filters using your own LeadMagic connection, with a page size capped at 50. Each returned job costs 1 credit; an empty result is free.

Input Parameters

integer
One-based result page number.
string
Job location text to match.
integer
Results per page (1-50). Each returned job costs 1 credit.
string
City name; pair with country_id when ambiguous.
string
Job title to match.
integer
Canonical region ID.
string
Country code such as US or GB.
boolean
True for remote-capable jobs or false for non-remote jobs.
integer
Canonical job-type ID.
string
Company name to match.
string
Only return jobs posted on or after this date.
integer
Maximum company employee count.
integer
Minimum company employee count.
string
Only return jobs posted on or before this date.
integer
Only return jobs posted within this many days.
integer
Canonical company-type ID.
string
Company website or domain to match.
string
Keyword or phrase to match in job descriptions.
string ("entry" | "mid" | "senior" | "executive")
Required experience level.
integer
Canonical company-industry 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: LEADMAGIC_FIND_LOOKALIKE_COMPANIES_V3Find similar companies from a seed domain, name, or description; managed requests require a bare domain and return at most 25 companies. A non-empty result costs 5 credits; an empty result is free.

Input Parameters

string
Alias for company_name.
object
Optional seed object; prefer seed.domain.
integer
Maximum lookalike companies to return (1-2000).
string
Alias for company_domain.
integer
Zero-based result offset.
object
Alias for company_filters.
string
Seed website URL or domain.
string
Free-text seed description.
string
Seed company name used when no domain is supplied.
string
Seed company domain.
object
Full Company Search filter object.
string
Alias for website.
string
Alias for description.

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: LEADMAGIC_FIND_MOBILE_PHONEFind one person’s mobile phone number from a professional profile URL or known email. A found mobile costs 5 credits and no result is free; managed access is not available.

Input Parameters

string
A known work email for the person.
string
The person’s professional profile URL or profile identifier.
string
A known personal email for the person.

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: LEADMAGIC_FIND_PERSONAL_EMAILFind one person’s personal email addresses from a professional profile URL or identifier. A found email costs 2 credits. Personal email addresses are sensitive personal data; use this tool only for a lawful, authorized purpose.

Input Parameters

string
required
The person’s professional profile URL or profile identifier.

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: LEADMAGIC_FIND_PERSON_BY_ROLE_V1Find one person by job title at a specified company using a connected API key; a found match costs 2 credits. The response can contain personal identity and professional profile data; managed credentials are unavailable for this action.

Input Parameters

string
required
Job title or role to find at the company.
string
Company name or business profile identifier. Provide this or company_domain.
string
Company website domain. Provide this or company_name.

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: LEADMAGIC_FIND_WORK_EMAILFind one person’s work email from their name and company domain or name. A found valid email costs 1 credit; no result is free. Exactly one person is processed per call.

Input Parameters

string
The person’s full name. Provide this or first_name.
string
The person’s last name; use with first_name when known.
string
The person’s first name when not using full_name.
string
The employer’s name when its domain is unknown. Provide this or company_domain.
string
The employer’s bare domain, such as example.com. Provide this or company_name.

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: LEADMAGIC_FIND_WORK_EMAIL_FROM_B2B_PROFILEFind one person’s work email from a professional profile URL or slug. A found email costs up to 5 credits.

Input Parameters

string
required
The person’s professional profile URL or profile slug.

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: LEADMAGIC_GET_ACCOUNT_OVERVIEWGet the connected workspace’s available credits, API-key permission summary, current rate limits, and today’s usage using your own LeadMagic API key. This read 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: LEADMAGIC_GET_ANALYTICS_ALL_TIME_SUMMARYGet lifetime account request, credit, product, success, and latency statistics, optionally restricted to a date range, using your own LeadMagic API key. This analytics read is free.

Input Parameters

string
Optional last date to include, in YYYY-MM-DD format.
string
Optional first date to include, in YYYY-MM-DD format.

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: LEADMAGIC_GET_ANALYTICS_CREDIT_HISTORYGet LeadMagic credit consumption history with a daily breakdown using your own LeadMagic API key.

Input Parameters

integer
Number of days to include, from 1 through 90.

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: LEADMAGIC_GET_ANALYTICS_DAILY_METRICSGet daily request, credit, latency, and error metrics for the last 1 to 90 days using your own LeadMagic API key. This analytics read is free.

Input Parameters

integer
Number of days to include, from 1 through 90.

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: LEADMAGIC_GET_ANALYTICS_DAY_BREAKDOWNGet the per-product request and credit breakdown for one date using your own LeadMagic API key. This analytics read is free.

Input Parameters

string
required
Date to inspect, in YYYY-MM-DD format.

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: LEADMAGIC_GET_ANALYTICS_PRODUCTSGet per-product LeadMagic usage with request, credit, and success metrics using your own LeadMagic API key.

Input Parameters

integer
Number of days to include, from 1 through 90.

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: LEADMAGIC_GET_ANALYTICS_USAGEGet daily LeadMagic usage with request, credit, and chargeable-rate totals using your own LeadMagic API key.

Input Parameters

integer
Number of days to include, from 1 through 90.

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: LEADMAGIC_GET_B2B_AD_DETAILS_V1Get full details for a specific B2B ad from its library URL, detail path, or numeric ID. A found detail lookup costs 2 credits.

Input Parameters

string
required
B2B ad library URL, /ad-library/detail/{id} path, or numeric ad ID. A found detail lookup costs 2 credits.

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: LEADMAGIC_GET_B2B_PROFILE_FROM_EMAILFind one person’s professional profile from a supplied work or personal email using your own LeadMagic API key; a found complete profile costs 10 credits. Email addresses and matched profile data are personal data; use them only for a lawful, authorized purpose.

Input Parameters

string
A known work email for the person.
string
A known personal email for the person.

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: LEADMAGIC_GET_B2B_PROFILE_FROM_PROFILE_URLRetrieve one person’s professional profile, including employment, education, certifications, and honors, from a profile URL or slug. A found profile costs 1 credit. Returned profile data is personal data; use it only for a lawful, authorized purpose.

Input Parameters

string
required
The person’s professional profile URL or profile slug.

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: LEADMAGIC_GET_BATCHRead status, progress, cost, and metadata for a mixed-product batch by its exact batch identifier using your own LeadMagic API key.

Input Parameters

string
required
Batch identifier returned by mixed-product batch submission.

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: LEADMAGIC_GET_BATCH_CAMPAIGN_METRICSRead aggregate usage and success metrics for a batch campaign using your own LeadMagic API key.

Input Parameters

string
required
Campaign identifier used to group related batches.

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: LEADMAGIC_GET_BATCH_CLIENT_METRICSRead aggregate batch usage and success metrics for one client UUID using your own LeadMagic API key.

Input Parameters

string
required
UUID of the batch client whose aggregate metrics should be returned.

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: LEADMAGIC_GET_BULK_CAPABILITIESRetrieve LeadMagic bulk submission limits and operational features to help plan bulk jobs. This action is unavailable with managed credentials.

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: LEADMAGIC_GET_BULK_JOBRead status, progress, timestamps, and reported finalized credit usage for one owned bulk job. This action is unavailable with managed credentials.

Input Parameters

string
required
UUID captured from a bulk job created by this workflow.

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: LEADMAGIC_GET_BULK_JOB_PROGRESSReturn a compact progress snapshot for frequent polling of one bulk job owned by the connected workspace. This read does not start, stop, or restart processing. It is unavailable with managed credentials.

Input Parameters

string
Signed progress token returned when this bulk job was submitted.
string
required
UUID of a bulk job owned by the connected workspace, normally captured from Submit Bulk Job in the same workflow.

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: LEADMAGIC_GET_COMPANY_FUNDING_V1Call POST /v1/companies/company-funding to get complete funding history and related company intelligence by domain or name. A found funding result costs 4 credits.

Input Parameters

string
Company name.
string
Company domain, such as example.com.

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: LEADMAGIC_GET_COMPANY_FUNDING_V3_COMPANY_DOCS_ALIASSearch company funding through POST /v3/companies/company-funding and return one cursor-controlled page. Managed access is not qualified; use a connected API key.

Input Parameters

integer
Maximum companies on this page (1-50). This does not fetch later pages.
string
Free-text company search query.
string
Opaque next_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
string
Documented alias for company_domain.
integer
Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
string
Company website URL or domain.
string
Professional company profile URL.
string
Company name to look up or search.
string
Documented alias for a professional company profile URL.
string
Direct one-company lookup domain, such as example.com.
object
Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.

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: LEADMAGIC_GET_COMPANY_FUNDING_V3_DOCS_ALIASSearch company funding through POST /v3/companies/funding and return one cursor-controlled page. Managed access is not qualified; use a connected API key.

Input Parameters

integer
Maximum companies on this page (1-50). This does not fetch later pages.
string
Free-text company search query.
string
Opaque next_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
string
Documented alias for company_domain.
integer
Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
string
Company website URL or domain.
string
Professional company profile URL.
string
Company name to look up or search.
string
Documented alias for a professional company profile URL.
string
Direct one-company lookup domain, such as example.com.
object
Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.

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: LEADMAGIC_GET_COMPANY_TECHNOGRAPHICS_V1Get a company’s technology stack from its domain. A found stack costs 1 credit.

Input Parameters

string
required
Domain of the company whose technology stack should be analyzed.

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: LEADMAGIC_GET_CREDIT_BALANCE_V1Check the connected LeadMagic workspace’s current credit balance. Managed access is not qualified; use a connected API key.

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: LEADMAGIC_GET_CREDIT_BUDGET_STATUSRead current limits, remaining credits, and exceeded state for LeadMagic credit budgets. Managed access is not qualified; use a connected API key.

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: LEADMAGIC_GET_CREDIT_SERVICE_HEALTH_V1_DOCS_ONLYCheck the connected LeadMagic API key’s credit-service authentication status. This action is unavailable with managed credentials.

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: LEADMAGIC_GET_EMAIL_SUPPRESSION_LISTReturn one offset-controlled page of details and SHA-256 email hashes for a suppression list created by the workflow, continuing with the returned next_offset. This action is unavailable with managed credentials.

Input Parameters

integer
Maximum email hashes to return in this page (1-1000).
integer
Zero-based hash offset. Continue only with next_offset from the prior response.
string
required
Exact suppression-list identifier captured from Create Email Suppression List in the same owned lifecycle.

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: LEADMAGIC_GET_JOB_BOARD_STATS_V3Return job search dataset statistics through the job-board integration route. This action is unavailable with managed credentials.

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: LEADMAGIC_GET_JOB_SEARCH_CATALOGSReturn the free filter catalogs used by job search, including countries, regions, job types, industries, company types, and seniority values. This helper 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: LEADMAGIC_GET_JOB_SEARCH_DATASET_STATS_V3Return free public statistics for the LeadMagic Jobs Search index, including coverage and freshness. Managed requests accept the compact total-jobs and freshness format.

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: LEADMAGIC_GET_SEARCH_STATSReturn free cached coverage, capabilities, and top dimensions for selected LeadMagic search products; requested sections may be absent when unavailable. With managed credentials, only coverage and capabilities sections are supported.

Input Parameters

integer
Maximum top values per dimension (1-10).
array
Search products whose stats to request.
array
Stat sections to request.

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: LEADMAGIC_LIST_BATCH_CLIENTSList existing organization-scoped client records used to segment batch work using your own LeadMagic API key. This read does not create or modify clients.

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: LEADMAGIC_LIST_BATCH_CLIENT_WEBHOOKSList delivery webhooks configured for one batch client using your own LeadMagic API key. This read does not create, change, or invoke webhooks.

Input Parameters

string
required
UUID of the batch client whose delivery webhooks should be listed.

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: LEADMAGIC_LIST_BATCHESList one page of batches for the connected organization, optionally filtered by product, status, or client. Use the returned next_offset to continue; additional pages are not fetched automatically. This action is unavailable with managed credentials.

Input Parameters

integer
Maximum batches to return (1-200).
integer
Zero-based result offset. Use next_offset from the prior response to continue.
string
Filter batches by provider batch status.
string
Filter batches by enrichment product.
string
Filter batches by associated client identifier.

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: LEADMAGIC_LIST_BULK_JOB_ERRORSCheck a page of bulk-job errors for a job owned by the connected workspace, using offset pagination and an optional status filter. Failed-row details are unavailable through this action. It is read-only, does not retry or restart rows, and is unavailable with managed credentials.

Input Parameters

integer
Maximum failed rows to return in this page (1-1000).
string
required
UUID of a bulk job owned by the connected workspace, normally captured from Submit Bulk Job in the same workflow.
integer
Zero-based failed-row offset for this page (0-1000000).
string
Optional provider status value used to filter failed rows.

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: LEADMAGIC_LIST_BULK_JOB_EVENTSReturn the append-only event log, newest first, for one owned bulk job. This read does not alter the job lifecycle and is unavailable with managed credentials.

Input Parameters

integer
Maximum append-only events to return, newest first (1-2000).
string
required
UUID of a bulk job owned by the connected workspace, normally captured from Submit Bulk Job in the same workflow.

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: LEADMAGIC_LIST_BULK_JOB_RESULTSReturn one offset page of row-level JSON results for an owned bulk job, with an optional status filter and a page size of up to 1,000 rows. Use a job ID captured from the same submission chain and pass next_offset explicitly to continue; this tool does not fetch all pages automatically. This action is unavailable with managed credentials.

Input Parameters

integer
Maximum rows in this page (1-1000).
string
required
UUID captured from a bulk job created by this workflow.
integer
Zero-based row offset for this page.
string
Optional row-status filter.

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: LEADMAGIC_LIST_BULK_JOBSReturn one bounded offset page of bulk jobs owned by the connected account, newest first, with next_offset for continuation. This action is unavailable with managed credentials.

Input Parameters

integer
Number of jobs in this page (1-200).
integer
Number of jobs to skip (0-10000). Pass next_offset to continue.
string
Filter jobs by current status.
string
Filter jobs by enrichment product.

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: LEADMAGIC_LIST_CREDIT_BUDGETSList credit budgets configured for the connected LeadMagic workspace, including their identifiers. Managed access is not qualified; use a connected API key.

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: LEADMAGIC_LIST_EMAIL_SUPPRESSION_LISTSRead suppression-list summaries for the connected workspace for discovery. For lifecycle writes, use the exact ID captured from a list created by that workflow, not an ID discovered through this listing. This action is unavailable with managed credentials.

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: LEADMAGIC_LIST_EXTERNAL_BATCH_PROVIDERSList organization-level external enrichment provider configurations. This action is unavailable with managed credentials.

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: LEADMAGIC_LIST_JOB_COMPANY_TYPES_V1List company type IDs for the legacy V1 Jobs Finder API. This action is unavailable with managed credentials.

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: LEADMAGIC_LIST_JOB_COUNTRIES_V1List country codes for the legacy V1 Jobs Finder API. This action is unavailable with managed credentials.

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: LEADMAGIC_LIST_JOB_INDUSTRIES_V1List industry IDs for the legacy V1 Jobs Finder API. This action is unavailable with managed credentials.

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: LEADMAGIC_LIST_JOB_OCCUPATION_TAXONOMY_V3Autocomplete LeadMagic’s broad-to-specific occupation taxonomy and return canonical IDs, labels, levels, and paths. This helper is free.

Input Parameters

string ("level1" | "level2" | "level3")
Restrict results to a broad family, category, or normalized title level.
integer
Number of taxonomy entries to return.
string
Free-text occupation query.

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: LEADMAGIC_LIST_JOB_REGIONS_V1List region IDs for the legacy V1 Jobs Finder API. This action is unavailable with managed credentials.

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: LEADMAGIC_LIST_JOB_SEARCH_COMPANY_SUGGESTIONS_V3Autocomplete companies or resolve an exact domain into canonical company IDs and card data for Job Search filters. This helper is free.

Input Parameters

integer
Number of company candidates to return.
string
Free-text company name or domain to match.
string
Exact company domain to look up.

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: LEADMAGIC_LIST_JOB_SEARCH_LOCATION_SUGGESTIONS_V3Autocomplete countries, regions, states, and cities into canonical IDs for exact Job Search geo filters. This helper is free.

Input Parameters

string ("country" | "region" | "state" | "city")
Location type to search: country, region, state, or city.
integer
Number of location candidates to return.
string
Free-text country, region, state, or city query.

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: LEADMAGIC_LIST_JOB_SEARCH_ROLE_SUGGESTIONS_V3Autocomplete role names into canonical occupation taxonomy IDs for Job Search filters. This helper is free.

Input Parameters

integer
Number of role candidates to return.
string
Free-text role query.

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: LEADMAGIC_LIST_JOB_SEARCH_TAG_SUGGESTIONS_V3Autocomplete normalized job tags with tag-type and occupation taxonomy metadata for Job Search filters. This helper is free.

Input Parameters

integer
Number of tag candidates to return.
string
Free-text tag query, such as a tool, platform, or skill prefix.
integer
Optional tag-type ID used to restrict suggestions.

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: LEADMAGIC_LIST_JOB_SEARCH_TITLE_SUGGESTIONS_V3Autocomplete searchable job title phrases with occupation taxonomy metadata for Job Search filters. This helper is free.

Input Parameters

integer
Number of title candidates to return.
string
Free-text job title query.

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: LEADMAGIC_LIST_JOB_TYPES_V1List job type IDs for the legacy V1 Jobs Finder API using your own LeadMagic connection. Returns reference data only.

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: LEADMAGIC_LOOKUP_COMPANY_DOMAIN_V3_DOCS_ALIASLook up companies through POST /v3/companies/domain-lookup using your own LeadMagic connection, returning one cursor-controlled page. Calls may incur charges.

Input Parameters

integer
Maximum companies on this page (1-50). This does not fetch later pages.
string
Free-text company search query.
string
Opaque next_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
string
Documented alias for company_domain.
integer
Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
string
Company website URL or domain.
string
Professional company profile URL.
string
Company name to look up or search.
string
Documented alias for a professional company profile URL.
string
Direct one-company lookup domain, such as example.com.
object
Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.

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: LEADMAGIC_LOOKUP_COMPANY_V3_DOCS_ALIASLook up companies through POST /v3/companies/lookup using your own LeadMagic connection, returning one cursor-controlled page. Calls may incur charges.

Input Parameters

integer
Maximum companies on this page (1-50). This does not fetch later pages.
string
Free-text company search query.
string
Opaque next_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
string
Documented alias for company_domain.
integer
Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
string
Company website URL or domain.
string
Professional company profile URL.
string
Company name to look up or search.
string
Documented alias for a professional company profile URL.
string
Direct one-company lookup domain, such as example.com.
object
Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.

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: LEADMAGIC_PAUSE_BULK_JOBPause a queued or running LeadMagic bulk job owned by the connected workspace, changing its processing state. Managed access is not available.

Input Parameters

string
required
UUID of a queued or running bulk job created and owned by the connected workspace. Never pause a pre-existing job selected from an unrelated list.

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: LEADMAGIC_PREVIEW_MIXED_BATCH_COSTEstimate the maximum credit cost and budget impact of a mixed-product batch payload using a connected API key. This free dry run does not submit work, reserve credits, or consume credits; managed credentials are unavailable for this action.

Input Parameters

array
required
One to 10,000 batch items to estimate without submitting work.
object
Optional metadata for the whole preview.
string
Optional client identifier for the whole preview.
string
Optional client name for the whole preview.
string
User ID whose configured credit budget should be checked by the preview.

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: LEADMAGIC_REFRESH_CREDIT_CACHE_V1_DOCS_ONLYRequest a refresh of the connected workspace’s credit cache using a connected API key. This updates cached account state; the response schema is undocumented and managed credentials are unavailable for this action.

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: LEADMAGIC_REMOVE_EMAILS_FROM_SUPPRESSION_LISTRemove specific email suppressions from a list created by the workflow, allowing those addresses to be processed again, using the lifecycle-owned list ID and previously added plaintext addresses. This action is unavailable with managed credentials.

Input Parameters

array
required
Non-empty plaintext email list to unsuppress. Each address must be the exact lifecycle-owned value previously added to this list.
string
required
Exact suppression-list identifier captured from Create Email Suppression List in the same owned lifecycle.

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: LEADMAGIC_RESOLVE_JOB_SEARCH_FILTERS_V3Resolve job-search companies, tags, occupation taxonomy, locations, and titles into canonical filter values using a connected API key. This helper returns no jobs and is unavailable with managed credentials.

Input Parameters

object
Job tags to resolve.
object
Title filters to resolve.
object
Location filters to resolve.
object
Company filters to resolve.
object
Occupation taxonomy filters sent under the exact occupationTaxonomy key.

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: LEADMAGIC_RESTART_BULK_JOBDestructively restart a LeadMagic bulk job in full, for failed rows only, or from a zero-based row or shard using a connected API key. This irreversible operation can repeat work and add to the price; managed credentials are unavailable for this action.

Input Parameters

string ("full" | "failed_only" | "from_row" | "from_shard")
Rows to reprocess: full, failed_only, from_row, or from_shard. Restarting can repeat enrichment work and add to the price.
string
required
UUID of a bulk job created and owned by the connected workspace. Never restart a pre-existing job selected from an unrelated list.
integer
Zero-based row index; required only when mode is from_row.
integer
Zero-based shard index; required only when mode is from_shard.

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: LEADMAGIC_RESUME_BULK_JOBResume a paused LeadMagic bulk job using a connected API key; this mutates processing state and may continue the job’s existing charged work. Use only a job intentionally paused in this workflow and owned by the connected workspace; managed credentials are unavailable for this action.

Input Parameters

string
required
UUID of a paused bulk job created and owned by the connected workspace. Never resume a pre-existing job selected from an unrelated list.

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: LEADMAGIC_REVIEW_BULK_JOBResume or irreversibly cancel an owned bulk job using a connected API key. Use a job ID from the same submission chain and choose a state-valid transition; managed credentials are unavailable for this action.

Input Parameters

string ("approve" | "reject")
required
approve resumes a paused job; reject cancels a queued or processing job.
string
required
UUID captured from a bulk job created by this workflow.

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: LEADMAGIC_SEARCH_B2B_ADS_V1Search for B2B ads by company domain or name. Costs 1 credit per search plus 1 credit per returned ad. Set limit to cap the per-ad portion.

Input Parameters

integer
Maximum ads to return (1-100). Caps the 1-credit-per-ad portion; the 1 base credit per search still applies. Defaults to 1.
string
Company name to search. Provide this or company_domain.
string
Company domain to search. Provide this or company_name.

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: LEADMAGIC_SEARCH_COMPANIESSearch or look up companies through POST /v3/companies/search, returning one page with a limit of 50; search charges depend on the plan. Managed credentials support only a first-page bare-domain lookup, with a limit of 10.

Input Parameters

integer
Maximum companies in this page (1-50). Each search costs 1 credit, whatever the page size.
string
A free-text company search query.
string
Opaque next_cursor from the previous response. Pass it unchanged; the original criteria and limit are retained by the cursor.
string
Alias for company_domain accepted by LeadMagic.
integer
Legacy result offset. Prefer cursor pagination; restart at offset 0 to obtain a stable cursor.
string
A company website URL or domain.
string
A professional company profile URL.
string
A company name to look up or search.
string
Alias for profile_url accepted by LeadMagic.
string
A bare domain for a direct company lookup.
object
Structured filters for company identity, firmographics, geography, funding, contact coverage, web presence, and technologies.

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: LEADMAGIC_SEARCH_COMPANIES_V1_LEGACY_DOCS_ALIASSearch companies through the legacy POST /v1/companies/search compatibility route, returning one cursor-controlled page. This action is unavailable with managed credentials.

Input Parameters

integer
Maximum companies on this page (1-50). This does not fetch later pages.
string
Free-text company search query.
string
Opaque next_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
string
Documented alias for company_domain.
integer
Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
string
Company website URL or domain.
string
Professional company profile URL.
string
Company name to look up or search.
string
Documented alias for a professional company profile URL.
string
Direct one-company lookup domain, such as example.com.
object
Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.

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: LEADMAGIC_SEARCH_COMPANIES_V3_COMPANY_HYPHENATED_DOCS_ALIASSearch companies through POST /v3/companies/company-search, returning one cursor-controlled page. This action is unavailable with managed credentials.

Input Parameters

integer
Maximum companies on this page (1-50). This does not fetch later pages.
string
Free-text company search query.
string
Opaque next_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
string
Documented alias for company_domain.
integer
Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
string
Company website URL or domain.
string
Professional company profile URL.
string
Company name to look up or search.
string
Documented alias for a professional company profile URL.
string
Direct one-company lookup domain, such as example.com.
object
Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.

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: LEADMAGIC_SEARCH_GOOGLE_ADS_V1Search for Google ads run by a company. Each returned ad costs 1 credit; no results is free. The limit defaults to 1 to keep the price low.

Input Parameters

integer
Maximum ads to return (1-100). Each returned ad costs 1 credit, so this caps the price. Defaults to 1.
string
Company name to search. Provide this or company_domain.
string
Company domain to search. Provide this or company_name.

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: LEADMAGIC_SEARCH_JOBSSearch jobs by title, company, location, taxonomy, tags, salary, seniority, date, and work arrangement using your own LeadMagic connection, returning one cursor-controlled page of up to 5 jobs. Search pricing depends on the plan.

Input Parameters

string ("fast" | "deep")
Use fast for normal browsing; deep enables broader text matching.
object
Job tag criteria using names or canonical IDs.
integer
Maximum jobs in this page (1-5). Each returned job costs 1 credit.
string
Opaque next_cursor from the previous response. Pass it unchanged; the original filters and limit are retained by the cursor.
object
Normalized annual salary bounds in USD.
object
Title criteria with include and exclude terms and optional vector matching.
object
Location criteria using country, region, state, and city values.
object
Company criteria using names, domains, or canonical numeric IDs.
array
Seniority labels to include, such as EN, MI, SE, or EX.
boolean
When true, require jobs marked as supporting remote work.
string
Only include jobs posted on or after this YYYY-MM-DD date.
string
Only include jobs posted on or before this YYYY-MM-DD date.
integer
Only include jobs posted within the last N days.
boolean
Include job description text; this can increase latency and response size.
object
Occupation taxonomy filters grouped into level1, level2, and level3.

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: LEADMAGIC_SEARCH_JOBS_V1_LEGACY_DOCS_ALIASSearch jobs through POST /v1/jobs/search using your own LeadMagic connection, returning one cursor page. Each search costs 1 credit.

Input Parameters

string ("fast" | "deep")
fast browses normally; deep enables broader text matching.
object
Job tag filters.
integer
Maximum jobs in this page (1-50).
string
Opaque next_cursor from the previous page; pass it unchanged.
object
Salary filters in USD.
object
Job title filters.
object
Location filters.
object
Company filters.
array
Job languages to include.
array
Seniority codes to include.
boolean
Whether to require jobs supporting remote work.
string ("none" | "capped" | "exact")
Count mode for the result total.
boolean
Resolve friendly filter values to canonical IDs.
array
Industry IDs from the V1 industry catalog.
array
Job type IDs from the V1 job type catalog.
string
Only include jobs posted on or after this date.
string
Only include jobs posted on or before this date.
integer
Only include jobs posted within the last N days.
boolean
Include facet metadata; this may increase response time.
array
Company type IDs from the V1 company type catalog.
array
Company size codes to include.
boolean
Include job descriptions; this may increase response time.
object
Occupation taxonomy filters.

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: LEADMAGIC_SEARCH_JOBS_V2_LEGACY_DOCS_ALIASSearch jobs through POST /v2/jobs/search using your own LeadMagic connection, returning one cursor page. Each search costs 1 credit.

Input Parameters

string ("fast" | "deep")
fast browses normally; deep enables broader text matching.
object
Job tag filters.
integer
Maximum jobs in this page (1-50).
string
Opaque next_cursor from the previous page; pass it unchanged.
object
Salary filters in USD.
object
Job title filters.
object
Location filters.
object
Company filters.
array
Job languages to include.
array
Seniority codes to include.
boolean
Whether to require jobs supporting remote work.
string ("none" | "capped" | "exact")
Count mode for the result total.
boolean
Resolve friendly filter values to canonical IDs.
array
Industry IDs from the V1 industry catalog.
array
Job type IDs from the V1 job type catalog.
string
Only include jobs posted on or after this date.
string
Only include jobs posted on or before this date.
integer
Only include jobs posted within the last N days.
boolean
Include facet metadata; this may increase response time.
array
Company type IDs from the V1 company type catalog.
array
Company size codes to include.
boolean
Include job descriptions; this may increase response time.
object
Occupation taxonomy filters.

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: LEADMAGIC_SEARCH_JOBS_V3_HYPHENATED_OPENAPI_ALIASSearch jobs through POST /v3/jobs-search using your own LeadMagic connection and return one cursor-controlled page of up to 5 jobs. Search pricing depends on the plan.

Input Parameters

string ("fast" | "deep")
Search execution mode.
object
Tag filter criteria.
integer
Jobs in this page (1-5). Each returned job costs 1 credit.
string
Opaque next_cursor from the previous page; pass it unchanged.
object
Title search criteria.
object
Country filter criteria.
string ("none" | "capped" | "exact")
Count mode sent as the exact totalMode body key.

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: LEADMAGIC_SEARCH_JOBS_V3_SINGULAR_DOCS_ALIASSearch jobs through POST /v3/job-search using your own LeadMagic connection, returning one cursor page. Search pricing depends on the plan.

Input Parameters

string ("fast" | "deep")
fast browses normally; deep enables broader text matching.
object
Job tag filters.
integer
Maximum jobs in this page (1-50).
string
Opaque next_cursor from the previous page; pass it unchanged.
object
Salary filters in USD.
object
Job title filters.
object
Location filters.
object
Company filters.
array
Job languages to include.
array
Seniority codes to include.
boolean
Whether to require jobs supporting remote work.
string ("none" | "capped" | "exact")
Count mode for the result total.
boolean
Resolve friendly filter values to canonical IDs.
array
Industry IDs from the V1 industry catalog.
array
Job type IDs from the V1 job type catalog.
string
Only include jobs posted on or after this date.
string
Only include jobs posted on or before this date.
integer
Only include jobs posted within the last N days.
boolean
Include facet metadata; this may increase response time.
array
Company type IDs from the V1 company type catalog.
array
Company size codes to include.
boolean
Include job descriptions; this may increase response time.
object
Occupation taxonomy filters.

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: LEADMAGIC_SEARCH_META_ADS_V1Search for Meta ads by company domain or name. Each returned ad costs 1 credit; no results is free. The limit defaults to 1 to keep the price low.

Input Parameters

integer
Maximum ads to return (1-100). Each returned ad costs 1 credit, so this caps the price. Defaults to 1.
string
Company name to search. Provide this or company_domain.
string
Company domain to search. Provide this or company_name.

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: LEADMAGIC_SEARCH_PEOPLESearch people by company, title, role, free text and contact availability, returning one cursor-controlled page without requesting raw email or mobile details. Managed access is not available, and search pricing depends on the plan.

Input Parameters

integer
Maximum people in this page (1-10). Each returned person costs 1 credit.
string
Free-text person or title query.
array
Role or function labels to match.
string
Opaque next_cursor from the previous response. Pass it unchanged; the original filters and limit are retained by the cursor.
array
Job titles to match; values within this list are alternatives.
string
Limit results to a company name when the domain is unknown.
string
Limit results to a company domain.
boolean
Only return people for whom email availability is known; this does not unlock or return the raw email.
boolean
Only return people for whom mobile availability is known; this does not unlock or return the raw number.

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: LEADMAGIC_SEARCH_PEOPLE_V1_LEGACY_DOCS_ALIASSearch people through the legacy POST /v1/people/search compatibility route, returning one base-only cursor page without requesting raw contact details. Managed access is not available.

Input Parameters

integer
Maximum people in this page (1-10); each returned person costs 1 credit.
string
Free-text people or title query.
array
Role or function labels to match.
string
Single title filter.
string
Opaque continuation cursor; pass it unchanged without repeating filters.
array
Job titles to match as alternatives.
array
Legacy contactability availability requirements.
string
Legacy single job-title filter.
string
Company name search anchor.
string
B2B company profile URL or slug search anchor.
string ("any" | "all")
Whether any or all requested channels must be available.
string
Company domain search anchor.
object
People filters; list values are ORed and different keys are ANDed.
boolean
Require known email availability without returning the raw email.
object
Criteria-based company search anchor using Company Search filters.
boolean
Include base company data with each person.
boolean
Require known mobile availability without returning the raw number.
boolean
Include base domain intelligence with each person.

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: LEADMAGIC_SEARCH_PEOPLE_V2_LEGACY_DOCS_ALIASSearch people through the legacy POST /v2/people/search compatibility route, returning one base-only cursor page without requesting raw contact details. Managed access is not available.

Input Parameters

integer
Maximum people in this page (1-10); each returned person costs 1 credit.
string
Free-text people or title query.
array
Role or function labels to match.
string
Single title filter.
string
Opaque continuation cursor; pass it unchanged without repeating filters.
array
Job titles to match as alternatives.
array
Legacy contactability availability requirements.
string
Legacy single job-title filter.
string
Company name search anchor.
string
B2B company profile URL or slug search anchor.
string ("any" | "all")
Whether any or all requested channels must be available.
string
Company domain search anchor.
object
People filters; list values are ORed and different keys are ANDed.
boolean
Require known email availability without returning the raw email.
object
Criteria-based company search anchor using Company Search filters.
boolean
Include base company data with each person.
boolean
Require known mobile availability without returning the raw number.
boolean
Include base domain intelligence with each person.

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: LEADMAGIC_SEARCH_PEOPLE_V3_BY_TITLE_DOCS_ALIASSearch people through POST /v3/people/by-title, returning one base-only cursor page without requesting raw contact details. Managed access is not available.

Input Parameters

integer
Maximum people in this page (1-10); each returned person costs 1 credit.
string
Free-text people or title query.
array
Role or function labels to match.
string
Single title filter.
string
Opaque continuation cursor; pass it unchanged without repeating filters.
array
Job titles to match as alternatives.
array
Legacy contactability availability requirements.
string
Legacy single job-title filter.
string
Company name search anchor.
string
B2B company profile URL or slug search anchor.
string ("any" | "all")
Whether any or all requested channels must be available.
string
Company domain search anchor.
object
People filters; list values are ORed and different keys are ANDed.
boolean
Require known email availability without returning the raw email.
object
Criteria-based company search anchor using Company Search filters.
boolean
Include base company data with each person.
boolean
Require known mobile availability without returning the raw number.
boolean
Include base domain intelligence with each person.

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: LEADMAGIC_SEARCH_PEOPLE_V3_COMPANY_DOCS_ALIASSearch people through POST /v3/people/company-search, returning one cursor page without requesting raw contact details. Managed access is not available.

Input Parameters

integer
People to return on this cursor page (1-10), charged per returned person.
string
Free-text people or title query.
array
Role or function labels to match.
string
Single job title to match.
string
Opaque next_cursor from the prior page. Pass unchanged; filters are retained.
array
Job titles to match as alternatives.
array
Legacy contact-availability requirements.
string
Legacy single job-title filter.
string
Company name to search.
string
Professional company profile URL or slug.
string ("any" | "all")
Whether any or all requested channels must be available.
string
Company domain to search.
object
People-level filters. Different keys are ANDed; array values are alternatives.
boolean
Require known email availability; raw email is never unlocked.
object
Documented Company Search filters defining the company set.
boolean
Include base company data with each person.
boolean
Require known mobile availability; raw numbers are never unlocked.
boolean
Include base domain intelligence with each person.

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: LEADMAGIC_SEARCH_PEOPLE_V3_CONTACTS_BY_TITLE_DOCS_ALIASSearch people through POST /v3/people/contacts-by-title, returning one base-only cursor page without requesting raw contact details. Managed access is not available.

Input Parameters

integer
Maximum people in this page (1-10); each returned person costs 1 credit.
string
Free-text people or title query.
array
Role or function labels to match.
string
Single title filter.
string
Opaque continuation cursor; pass it unchanged without repeating filters.
array
Job titles to match as alternatives.
array
Legacy contactability availability requirements.
string
Legacy single job-title filter.
string
Company name search anchor.
string
B2B company profile URL or slug search anchor.
string ("any" | "all")
Whether any or all requested channels must be available.
string
Company domain search anchor.
object
People filters; list values are ORed and different keys are ANDed.
boolean
Require known email availability without returning the raw email.
object
Criteria-based company search anchor using Company Search filters.
boolean
Include base company data with each person.
boolean
Require known mobile availability without returning the raw number.
boolean
Include base domain intelligence with each person.

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: LEADMAGIC_SEARCH_PEOPLE_V3_EMPLOYEES_DOCS_ALIASSearch people through POST /v3/people/employees, returning one base-only cursor page without requesting raw contact details. Managed access is not available.

Input Parameters

integer
Maximum people in this page (1-10); each returned person costs 1 credit.
string
Free-text people or title query.
array
Role or function labels to match.
string
Single title filter.
string
Opaque continuation cursor; pass it unchanged without repeating filters.
array
Job titles to match as alternatives.
array
Legacy contactability availability requirements.
string
Legacy single job-title filter.
string
Company name search anchor.
string
B2B company profile URL or slug search anchor.
string ("any" | "all")
Whether any or all requested channels must be available.
string
Company domain search anchor.
object
People filters; list values are ORed and different keys are ANDed.
boolean
Require known email availability without returning the raw email.
object
Criteria-based company search anchor using Company Search filters.
boolean
Include base company data with each person.
boolean
Require known mobile availability without returning the raw number.
boolean
Include base domain intelligence with each person.

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: LEADMAGIC_SEARCH_PEOPLE_V3_FULL_DOCS_ALIASSearch for people using the V3 full-search alias, with company and people filters and cursor pagination. Results contain base person records without raw email or phone details. This action is unavailable with managed credentials.

Input Parameters

integer
People to return on this cursor page (1-10), each returned person costs 1 credit.
string
Free-text people or title query.
array
Role or function labels to match.
string
Single job title to match.
string
Opaque next_cursor from the prior page. Pass unchanged; filters are retained.
array
Job titles to match as alternatives.
array
Legacy contact-availability requirements.
string
Legacy single job-title filter.
string
Company name to search.
string
Professional company profile URL or slug.
string ("any" | "all")
Whether any or all requested channels must be available.
string
Company domain to search.
object
People-level filters. Different keys are ANDed; array values are alternatives.
boolean
Require known email availability; raw email is never unlocked.
object
Documented Company Search filters defining the company set.
boolean
Include base company data with each person.
boolean
Require known mobile availability; raw numbers are never unlocked.
boolean
Include base domain intelligence with each person.

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: LEADMAGIC_SEARCH_PEOPLE_V3_ICP_DOCS_ALIASSearch people through POST /v3/people/icp-search, returning one base-only cursor page without requesting raw contact details. Managed access is not available.

Input Parameters

integer
Maximum people in this cursor page (1-10). Each returned person costs 1 credit; zero-result pages are free.
string
Free-text people or title query.
array
Role or function labels to match.
string
Single title filter.
string
Opaque next_cursor from the previous response. Pass it unchanged; all original filters and the limit are retained.
array
Job titles to match as alternatives.
array
Legacy contactability requirements; checks availability only.
string
Legacy single job-title filter.
string
Company name that anchors the search when no domain is known.
string
B2B company profile URL or slug that anchors the search.
string ("any" | "all")
Whether any or all requested channels must be available.
string
Company domain that anchors the people search.
object
People filters for names, titles, functions, levels, geography, profiles, languages, seniority, connection count, and channel availability. Values within one list are ORed; different keys are ANDed.
boolean
Only return people with known email availability; no raw email is returned.
object
Criteria-based company set using the documented Company Search filters.
boolean
Include base company data with each person.
boolean
Only return people with known mobile availability; no raw number is returned.
boolean
Include base domain intelligence with each person.

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: LEADMAGIC_SEARCH_PEOPLE_V3_LOOKALIKE_DOCS_ALIASSearch people through POST /v3/people/lookalike, returning one base-only cursor page without requesting raw contact details. Managed access is not available.

Input Parameters

integer
Maximum people in this page (1-10); each returned person costs 1 credit.
string
Free-text people or title query.
array
Role or function labels to match.
string
Single title filter.
string
Opaque continuation cursor; pass it unchanged without repeating filters.
array
Job titles to match as alternatives.
array
Legacy contactability availability requirements.
string
Legacy single job-title filter.
string
Company name search anchor.
string
B2B company profile URL or slug search anchor.
string ("any" | "all")
Whether any or all requested channels must be available.
string
Company domain search anchor.
object
People filters; list values are ORed and different keys are ANDed.
boolean
Require known email availability without returning the raw email.
object
Criteria-based company search anchor using Company Search filters.
boolean
Include base company data with each person.
boolean
Require known mobile availability without returning the raw number.
boolean
Include base domain intelligence with each person.

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: LEADMAGIC_SEARCH_PEOPLE_V3_MIXED_DOCS_ALIASSearch people through POST /v3/people/mixed-search, returning one cursor page without requesting raw contact details. Managed access is not available.

Input Parameters

integer
People to return on this cursor page (1-10), charged per returned person.
string
Free-text people or title query.
array
Role or function labels to match.
string
Single job title to match.
string
Opaque next_cursor from the prior page. Pass unchanged; filters are retained.
array
Job titles to match as alternatives.
array
Legacy contact-availability requirements.
string
Legacy single job-title filter.
string
Company name to search.
string
Professional company profile URL or slug.
string ("any" | "all")
Whether any or all requested channels must be available.
string
Company domain to search.
object
People-level filters. Different keys are ANDed; array values are alternatives.
boolean
Require known email availability; raw email is never unlocked.
object
Documented Company Search filters defining the company set.
boolean
Include base company data with each person.
boolean
Require known mobile availability; raw numbers are never unlocked.
boolean
Include base domain intelligence with each person.

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: LEADMAGIC_SEARCH_PEOPLE_V3_SINGULAR_DOCS_ALIASSearch people through POST /v3/person/search, returning one cursor page of base person data without requesting raw contacts. Managed access is not available.

Input Parameters

integer
People to return on this cursor page (1-10), charged per returned person.
string
Free-text people or title query.
array
Role or function labels to match.
string
Single job title to match.
string
Opaque next_cursor from the prior page. Pass it unchanged; filters are retained.
array
Job titles to match as alternatives.
array
Legacy contact-availability requirements.
string
Legacy single job-title filter.
string
Company name to search.
string
Professional company profile URL or slug.
string ("any" | "all")
Whether any or all requested channels must be available.
string
Company domain to search.
object
People-level filters. Different keys are combined with AND; array values are alternatives.
boolean
Only return people with known email availability; raw email is never unlocked.
object
Documented Company Search filters defining the company set.
boolean
Include base company data with each person.
boolean
Only return people with known mobile availability; raw numbers are never unlocked.
boolean
Include base domain intelligence with each person.

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: LEADMAGIC_SUBMIT_BULK_JOBCreate one asynchronous bulk enrichment job using exactly one input mode: inline rows, CSV, a remote file, or a scrape. Processing may incur charges. Retain the returned job ID for follow-up reads or lifecycle changes. This action is unavailable with managed credentials.

Input Parameters

string
Inline CSV data. Mutually exclusive with rows, file_url, and scrape.
array
Inline JSON row objects. Mutually exclusive with csv, file_url, and scrape.
string ("csv" | "json" | "jsonl")
Remote file format; valid only with file_url.
object
Browser-rendering input. Mutually exclusive with rows, csv, and file_url.
string
required
Enrichment product applied to every submitted row.
object
Optional webhook delivery configuration.
string
Public HTTPS CSV, JSON, or JSONL URL. Mutually exclusive with rows, csv, and scrape.
object
Caller metadata attached to the bulk job.
integer
Queue priority from -1000 to 1000.
string
Label shown for the job in the LeadMagic dashboard.
string
Saved bulk preset identifier.
object
Map source columns or fixed values to product input fields.
string
Stable key that makes retries resolve to the same submission.
object
Optional transformation applied to completed row output.

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: LEADMAGIC_SUBMIT_BULK_LOCAL_LEADS_JOBCreate a long-running local-leads bulk job from keywords and cities; each keyword-city combination may be charged. Retain the returned job ID and use that owned ID for follow-up reads or lifecycle changes. This action is unavailable with managed credentials.

Input Parameters

array
required
Cities expanded against every keyword.
array
required
Search terms expanded against every city, one row per keyword-city pair.
string
Label shown for the job in the LeadMagic dashboard.
string
Promotional key that waives charges only when LeadMagic accepts it.
array
Two-letter country code per city, aligned by index; omitted entries default to US.

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: LEADMAGIC_SUBMIT_MIXED_PRODUCT_BATCHCreate an asynchronous mixed-product enrichment batch of up to 500 items. Managed access is not available; batch lookups may consume credits.

Input Parameters

array
required
One to 500 mixed-product batch items. Every item explicitly names its product and input.
object
Arbitrary metadata stored with the whole batch.
string ("normal" | "low")
Queue priority for the batch.
string
Client identifier associated with the whole batch.
string
Client name recorded with the whole batch.
string
Public HTTPS URL to notify when the batch completes.
string
Member whose credit budget should be charged.
string
Deduplication key. Reusing it returns the original batch instead of creating another.

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: LEADMAGIC_UPDATE_BATCH_METADATAUpdate metadata or the client association for an owned batch during its mutable window. Use the product and batch ID captured from the same submitted batch, rather than a batch discovered by listing workspace data. This action is unavailable with managed credentials.

Input Parameters

string
required
Enrichment product slug for the batch. Hyphens and underscores are accepted.
string
required
Identifier of the owned batch to update.
object
Replacement provider-defined metadata for the batch.
string
Client identifier to associate with the batch.

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: LEADMAGIC_UPDATE_BULK_JOB_PRIORITYChange the priority of a queued or running LeadMagic bulk job owned by the connected workspace. This action is unavailable with managed credentials.

Input Parameters

string
required
UUID of a queued or running bulk job created and owned by the connected workspace. Never reprioritize a pre-existing unrelated job.
integer
required
New queue priority from -1000 (lowest) to 1000 (highest).

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: LEADMAGIC_UPDATE_CREDIT_BUDGETUpdate one or more controls on a credit budget created and owned by the caller, using its ID from the owned budget lifecycle. Managed access is not qualified; use a connected API key.

Input Parameters

string
required
Identifier of the owned budget to update.
string
Replacement budget reset period.
string
Replacement email address for budget threshold alerts.
number
Replacement credit limit for each budget period.
number
Replacement alert threshold as a fraction from 0 to 1.

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: LEADMAGIC_VALIDATE_BULK_SUBMISSIONValidate one bulk input mode and its options using a connected API key without persisting or processing a job. This contract check is unavailable with managed credentials.

Input Parameters

string
Inline CSV; exclusive with rows, file_url, and scrape.
array
Inline JSON rows; exclusive with csv, file_url, and scrape.
string ("csv" | "json" | "jsonl")
Format for file_url only.
object
Browser input; exclusive with rows, csv, and file_url.
string
required
Enrichment product to validate.
object
Callback configuration.
string
Public HTTPS input URL; exclusive with rows, csv, and scrape.
object
Job metadata.
integer
Queue priority from -1000 to 1000.
string
Dashboard job label.
string
Saved bulk preset identifier.
object
Source-to-product field mapping.
string
Submission idempotency key.
object
Completed-row output transformation.

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: LEADMAGIC_VALIDATE_EMAILCheck one email address for deliverability and return mail-server and company context when available. A definitive valid or invalid result costs 0.25 credits; an unknown result is free.

Input Parameters

string
required
The single email address to validate.

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