> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# LeadMagic

> LeadMagic provides people, company, jobs, advertising, and enrichment data for sales and recruiting workflows.

![LeadMagic logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/leadmagic.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=2654bc9d12fc2aaa9bda537cdf4e6284)

* **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

> [accordion] Add Emails To Suppression List
>
> **Slug:** `LEADMAGIC_ADD_EMAILS_TO_SUPPRESSION_LIST`
>
> Add 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
>
> **emails** `array` *required*
>
> Non-empty plaintext email list to add. LeadMagic normalizes and SHA-256 hashes each address server-side; use only lifecycle-owned addresses.
>
> **list\_id** `string` *required*
>
> Exact suppression-list identifier captured from Create Email Suppression List in the same owned lifecycle.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Credit Budget
>
> **Slug:** `LEADMAGIC_CREATE_CREDIT_BUDGET`
>
> Create 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
>
> **scope** `string` *required*
>
> Budget scope type defined by LeadMagic.
>
> **period** `string`
>
> Budget reset period defined by LeadMagic.
>
> **alert\_email** `string`
>
> Email address that receives budget threshold alerts.
>
> **max\_credits** `number` *required*
>
> Maximum credits available to this budget during each period.
>
> **scope\_value** `string` *required*
>
> Workspace value to which the budget applies.
>
> **alert\_threshold\_pct** `number`
>
> Fraction of the budget at which an alert is sent, from 0 to 1.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Email Suppression List
>
> **Slug:** `LEADMAGIC_CREATE_EMAIL_SUPPRESSION_LIST`
>
> Create 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
>
> **emails** `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.
>
> **list\_id** `string` *required*
>
> Unique identifier for the new suppression list. Use a workflow-specific value that cannot collide with a pre-existing workspace list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Job Search Export V3
>
> **Slug:** `LEADMAGIC_CREATE_JOB_SEARCH_EXPORT_V3`
>
> Synchronously 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
>
> **tags** `object`
>
> Job tag include and exclude filters.
>
> **limit** `integer`
>
> Maximum jobs to return (1-5000). Defaults to 1. The price grows with the number of jobs returned.
>
> **salary** `object`
>
> Normalized annual salary filters.
>
> **titles** `object`
>
> Title include, exclude, and semantic matching filters.
>
> **location** `object`
>
> Country, region, state, and city filters.
>
> **companies** `object`
>
> Company name, domain, or canonical ID filters.
>
> **work\_modes** `array`
>
> Canonical work-mode IDs to include.
>
> **posted\_within** `integer`
>
> Only return jobs posted within this many days (1-365).
>
> **include\_company** `boolean`
>
> Include company details for each exported job.
>
> **include\_description** `boolean`
>
> Include full job descriptions in the export.
>
> **occupation\_taxonomy** `object`
>
> Occupation taxonomy filters by hierarchy level.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Credit Budget
>
> **Slug:** `LEADMAGIC_DELETE_CREDIT_BUDGET`
>
> Permanently 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
>
> **id** `string` *required*
>
> Exact credit-budget identifier captured when this workflow created the budget. Never use an ID selected from pre-existing workspace budgets.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Email Suppression List
>
> **Slug:** `LEADMAGIC_DELETE_EMAIL_SUPPRESSION_LIST`
>
> Permanently 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
>
> **list\_id** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Detect Job Change
>
> **Slug:** `LEADMAGIC_DETECT_JOB_CHANGE`
>
> Check 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
>
> **profile\_url** `string` *required*
>
> Professional profile URL or identifier for the person to check.
>
> **company\_name** `string`
>
> Expected current company name. Provide this or company\_domain.
>
> **company\_domain** `string`
>
> Expected current company domain. Provide this or company\_name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Bulk Job Results CSV
>
> **Slug:** `LEADMAGIC_DOWNLOAD_BULK_JOB_RESULTS_CSV`
>
> Download 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
>
> **job\_id** `string` *required*
>
> UUID captured from a bulk job created by this workflow.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Enrich Company V1
>
> **Slug:** `LEADMAGIC_ENRICH_COMPANY_V1`
>
> Call 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 enriched
>
> **Discount:** 57
>
> #### Input Parameters
>
> **profile\_url** `string`
>
> Business company profile URL or identifier.
>
> **company\_name** `string`
>
> Company name when its domain or profile URL is unavailable.
>
> **company\_domain** `string`
>
> Company domain, such as example.com.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Enrich Company V3 Docs Alias
>
> **Slug:** `LEADMAGIC_ENRICH_COMPANY_V3_DOCS_ALIAS`
>
> Search 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
>
> **limit** `integer`
>
> Maximum companies on this page (1-50). This does not fetch later pages.
>
> **query** `string`
>
> Free-text company search query.
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
>
> **domain** `string`
>
> Documented alias for company\_domain.
>
> **offset** `integer`
>
> Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
>
> **website** `string`
>
> Company website URL or domain.
>
> **profile\_url** `string`
>
> Professional company profile URL.
>
> **company\_name** `string`
>
> Company name to look up or search.
>
> **linkedin\_url** `string`
>
> Documented alias for a professional company profile URL.
>
> **company\_domain** `string`
>
> Direct one-company lookup domain, such as example.com.
>
> **company\_filters** `object`
>
> Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Company Competitors V1
>
> **Slug:** `LEADMAGIC_FIND_COMPANY_COMPETITORS_V1`
>
> Find competitors from a company domain, profile, or name. A found competitor list costs 5 credits.
>
> #### Input Parameters
>
> **company\_url** `string`
>
> Business company profile URL or identifier.
>
> **company\_name** `string`
>
> Company name.
>
> **company\_domain** `string`
>
> Company website domain.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Company Employees V1
>
> **Slug:** `LEADMAGIC_FIND_COMPANY_EMPLOYEES_V1`
>
> Find 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
>
> **limit** `integer`
>
> Maximum employees to return (1-10). Each returned employee costs up to 1 credit; use 1 for the lowest price.
>
> **company\_name** `string`
>
> Company name when its domain is unavailable. Provide this or company\_domain.
>
> **company\_domain** `string`
>
> Company website domain, preferred when known. Provide this or company\_name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Jobs V1
>
> **Slug:** `LEADMAGIC_FIND_JOBS_V1`
>
> Find 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
>
> **page** `integer`
>
> One-based result page number.
>
> **location** `string`
>
> Job location text to match.
>
> **per\_page** `integer`
>
> Results per page (1-50). Each returned job costs 1 credit.
>
> **city\_name** `string`
>
> City name; pair with country\_id when ambiguous.
>
> **job\_title** `string`
>
> Job title to match.
>
> **region\_id** `integer`
>
> Canonical region ID.
>
> **country\_id** `string`
>
> Country code such as US or GB.
>
> **has\_remote** `boolean`
>
> True for remote-capable jobs or false for non-remote jobs.
>
> **job\_type\_id** `integer`
>
> Canonical job-type ID.
>
> **company\_name** `string`
>
> Company name to match.
>
> **posted\_after** `string`
>
> Only return jobs posted on or after this date.
>
> **max\_employees** `integer`
>
> Maximum company employee count.
>
> **min\_employees** `integer`
>
> Minimum company employee count.
>
> **posted\_before** `string`
>
> Only return jobs posted on or before this date.
>
> **posted\_within** `integer`
>
> Only return jobs posted within this many days.
>
> **company\_type\_id** `integer`
>
> Canonical company-type ID.
>
> **company\_website** `string`
>
> Company website or domain to match.
>
> **job\_description** `string`
>
> Keyword or phrase to match in job descriptions.
>
> **experience\_level** `string ("entry" | "mid" | "senior" | "executive")`
>
> Required experience level.
>
> **company\_industry\_id** `integer`
>
> Canonical company-industry ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Lookalike Companies V3
>
> **Slug:** `LEADMAGIC_FIND_LOOKALIKE_COMPANIES_V3`
>
> Find 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
>
> **name** `string`
>
> Alias for company\_name.
>
> **seed** `object`
>
> Optional seed object; prefer seed.domain.
>
> **limit** `integer`
>
> Maximum lookalike companies to return (1-2000).
>
> **domain** `string`
>
> Alias for company\_domain.
>
> **offset** `integer`
>
> Zero-based result offset.
>
> **filters** `object`
>
> Alias for company\_filters.
>
> **website** `string`
>
> Seed website URL or domain.
>
> **description** `string`
>
> Free-text seed description.
>
> **company\_name** `string`
>
> Seed company name used when no domain is supplied.
>
> **company\_domain** `string`
>
> Seed company domain.
>
> **company\_filters** `object`
>
> Full Company Search filter object.
>
> **company\_website** `string`
>
> Alias for website.
>
> **company\_description** `string`
>
> Alias for description.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Mobile Phone
>
> **Slug:** `LEADMAGIC_FIND_MOBILE_PHONE`
>
> Find 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
>
> **work\_email** `string`
>
> A known work email for the person.
>
> **profile\_url** `string`
>
> The person's professional profile URL or profile identifier.
>
> **personal\_email** `string`
>
> A known personal email for the person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Personal Email
>
> **Slug:** `LEADMAGIC_FIND_PERSONAL_EMAIL`
>
> Find 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
>
> **profile\_url** `string` *required*
>
> The person's professional profile URL or profile identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Person By Role V1
>
> **Slug:** `LEADMAGIC_FIND_PERSON_BY_ROLE_V1`
>
> Find 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
>
> **job\_title** `string` *required*
>
> Job title or role to find at the company.
>
> **company\_name** `string`
>
> Company name or business profile identifier. Provide this or company\_domain.
>
> **company\_domain** `string`
>
> Company website domain. Provide this or company\_name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Work Email
>
> **Slug:** `LEADMAGIC_FIND_WORK_EMAIL`
>
> Find 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
>
> **full\_name** `string`
>
> The person's full name. Provide this or first\_name.
>
> **last\_name** `string`
>
> The person's last name; use with first\_name when known.
>
> **first\_name** `string`
>
> The person's first name when not using full\_name.
>
> **company\_name** `string`
>
> The employer's name when its domain is unknown. Provide this or company\_domain.
>
> **company\_domain** `string`
>
> The employer's bare domain, such as example.com. Provide this or company\_name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Work Email From B2B Profile
>
> **Slug:** `LEADMAGIC_FIND_WORK_EMAIL_FROM_B2B_PROFILE`
>
> Find one person's work email from a professional profile URL or slug. A found email costs up to 5 credits.
>
> #### Input Parameters
>
> **profile\_url** `string` *required*
>
> The person's professional profile URL or profile slug.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account Overview
>
> **Slug:** `LEADMAGIC_GET_ACCOUNT_OVERVIEW`
>
> Get 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Analytics All Time Summary
>
> **Slug:** `LEADMAGIC_GET_ANALYTICS_ALL_TIME_SUMMARY`
>
> Get 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
>
> **end\_date** `string`
>
> Optional last date to include, in YYYY-MM-DD format.
>
> **start\_date** `string`
>
> Optional first date to include, in YYYY-MM-DD format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Analytics Credit History
>
> **Slug:** `LEADMAGIC_GET_ANALYTICS_CREDIT_HISTORY`
>
> Get LeadMagic credit consumption history with a daily breakdown using your own LeadMagic API key.
>
> #### Input Parameters
>
> **days** `integer`
>
> Number of days to include, from 1 through 90.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Analytics Daily Metrics
>
> **Slug:** `LEADMAGIC_GET_ANALYTICS_DAILY_METRICS`
>
> Get 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
>
> **days** `integer`
>
> Number of days to include, from 1 through 90.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Analytics Day Breakdown
>
> **Slug:** `LEADMAGIC_GET_ANALYTICS_DAY_BREAKDOWN`
>
> Get the per-product request and credit breakdown for one date using your own LeadMagic API key. This analytics read is free.
>
> #### Input Parameters
>
> **date** `string` *required*
>
> Date to inspect, in YYYY-MM-DD format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Analytics Products
>
> **Slug:** `LEADMAGIC_GET_ANALYTICS_PRODUCTS`
>
> Get per-product LeadMagic usage with request, credit, and success metrics using your own LeadMagic API key.
>
> #### Input Parameters
>
> **days** `integer`
>
> Number of days to include, from 1 through 90.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Analytics Usage
>
> **Slug:** `LEADMAGIC_GET_ANALYTICS_USAGE`
>
> Get daily LeadMagic usage with request, credit, and chargeable-rate totals using your own LeadMagic API key.
>
> #### Input Parameters
>
> **days** `integer`
>
> Number of days to include, from 1 through 90.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get B2B Ad Details V1
>
> **Slug:** `LEADMAGIC_GET_B2B_AD_DETAILS_V1`
>
> Get 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
>
> **ad\_url** `string` *required*
>
> B2B ad library URL, /ad-library/detail/\{id} path, or numeric ad ID. A found detail lookup costs 2 credits.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get B2B Profile From Email
>
> **Slug:** `LEADMAGIC_GET_B2B_PROFILE_FROM_EMAIL`
>
> Find 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
>
> **work\_email** `string`
>
> A known work email for the person.
>
> **personal\_email** `string`
>
> A known personal email for the person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get B2B Profile From Profile URL
>
> **Slug:** `LEADMAGIC_GET_B2B_PROFILE_FROM_PROFILE_URL`
>
> Retrieve 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
>
> **profile\_url** `string` *required*
>
> The person's professional profile URL or profile slug.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Batch
>
> **Slug:** `LEADMAGIC_GET_BATCH`
>
> Read status, progress, cost, and metadata for a mixed-product batch by its exact batch identifier using your own LeadMagic API key.
>
> #### Input Parameters
>
> **batch\_id** `string` *required*
>
> Batch identifier returned by mixed-product batch submission.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Batch Campaign Metrics
>
> **Slug:** `LEADMAGIC_GET_BATCH_CAMPAIGN_METRICS`
>
> Read aggregate usage and success metrics for a batch campaign using your own LeadMagic API key.
>
> #### Input Parameters
>
> **campaign\_id** `string` *required*
>
> Campaign identifier used to group related batches.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Batch Client Metrics
>
> **Slug:** `LEADMAGIC_GET_BATCH_CLIENT_METRICS`
>
> Read aggregate batch usage and success metrics for one client UUID using your own LeadMagic API key.
>
> #### Input Parameters
>
> **client\_id** `string` *required*
>
> UUID of the batch client whose aggregate metrics should be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Bulk Capabilities
>
> **Slug:** `LEADMAGIC_GET_BULK_CAPABILITIES`
>
> Retrieve LeadMagic bulk submission limits and operational features to help plan bulk jobs. This action is unavailable with managed credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Bulk Job
>
> **Slug:** `LEADMAGIC_GET_BULK_JOB`
>
> Read status, progress, timestamps, and reported finalized credit usage for one owned bulk job. This action is unavailable with managed credentials.
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> UUID captured from a bulk job created by this workflow.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Bulk Job Progress
>
> **Slug:** `LEADMAGIC_GET_BULK_JOB_PROGRESS`
>
> Return 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
>
> **token** `string`
>
> Signed progress token returned when this bulk job was submitted.
>
> **job\_id** `string` *required*
>
> UUID of a bulk job owned by the connected workspace, normally captured from Submit Bulk Job in the same workflow.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Company Funding V1
>
> **Slug:** `LEADMAGIC_GET_COMPANY_FUNDING_V1`
>
> Call 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
>
> **company\_name** `string`
>
> Company name.
>
> **company\_domain** `string`
>
> Company domain, such as example.com.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Company Funding V3 Company Docs Alias
>
> **Slug:** `LEADMAGIC_GET_COMPANY_FUNDING_V3_COMPANY_DOCS_ALIAS`
>
> Search 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
>
> **limit** `integer`
>
> Maximum companies on this page (1-50). This does not fetch later pages.
>
> **query** `string`
>
> Free-text company search query.
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
>
> **domain** `string`
>
> Documented alias for company\_domain.
>
> **offset** `integer`
>
> Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
>
> **website** `string`
>
> Company website URL or domain.
>
> **profile\_url** `string`
>
> Professional company profile URL.
>
> **company\_name** `string`
>
> Company name to look up or search.
>
> **linkedin\_url** `string`
>
> Documented alias for a professional company profile URL.
>
> **company\_domain** `string`
>
> Direct one-company lookup domain, such as example.com.
>
> **company\_filters** `object`
>
> Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Company Funding V3 Docs Alias
>
> **Slug:** `LEADMAGIC_GET_COMPANY_FUNDING_V3_DOCS_ALIAS`
>
> Search 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
>
> **limit** `integer`
>
> Maximum companies on this page (1-50). This does not fetch later pages.
>
> **query** `string`
>
> Free-text company search query.
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
>
> **domain** `string`
>
> Documented alias for company\_domain.
>
> **offset** `integer`
>
> Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
>
> **website** `string`
>
> Company website URL or domain.
>
> **profile\_url** `string`
>
> Professional company profile URL.
>
> **company\_name** `string`
>
> Company name to look up or search.
>
> **linkedin\_url** `string`
>
> Documented alias for a professional company profile URL.
>
> **company\_domain** `string`
>
> Direct one-company lookup domain, such as example.com.
>
> **company\_filters** `object`
>
> Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Company Technographics V1
>
> **Slug:** `LEADMAGIC_GET_COMPANY_TECHNOGRAPHICS_V1`
>
> Get a company's technology stack from its domain. A found stack costs 1 credit.
>
> #### Input Parameters
>
> **company\_domain** `string` *required*
>
> Domain of the company whose technology stack should be analyzed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Credit Balance V1
>
> **Slug:** `LEADMAGIC_GET_CREDIT_BALANCE_V1`
>
> Check the connected LeadMagic workspace's current credit balance. Managed access is not qualified; use a connected API key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Credit Budget Status
>
> **Slug:** `LEADMAGIC_GET_CREDIT_BUDGET_STATUS`
>
> Read current limits, remaining credits, and exceeded state for LeadMagic credit budgets. Managed access is not qualified; use a connected API key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Credit Service Health V1 Docs Only
>
> **Slug:** `LEADMAGIC_GET_CREDIT_SERVICE_HEALTH_V1_DOCS_ONLY`
>
> Check the connected LeadMagic API key's credit-service authentication status. This action is unavailable with managed credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Email Suppression List
>
> **Slug:** `LEADMAGIC_GET_EMAIL_SUPPRESSION_LIST`
>
> Return 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
>
> **limit** `integer`
>
> Maximum email hashes to return in this page (1-1000).
>
> **offset** `integer`
>
> Zero-based hash offset. Continue only with next\_offset from the prior response.
>
> **list\_id** `string` *required*
>
> Exact suppression-list identifier captured from Create Email Suppression List in the same owned lifecycle.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Job Board Stats V3
>
> **Slug:** `LEADMAGIC_GET_JOB_BOARD_STATS_V3`
>
> Return job search dataset statistics through the job-board integration route. This action is unavailable with managed credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Job Search Catalogs
>
> **Slug:** `LEADMAGIC_GET_JOB_SEARCH_CATALOGS`
>
> Return the free filter catalogs used by job search, including countries, regions, job types, industries, company types, and seniority values. This helper is free.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Job Search Dataset Stats V3
>
> **Slug:** `LEADMAGIC_GET_JOB_SEARCH_DATASET_STATS_V3`
>
> Return free public statistics for the LeadMagic Jobs Search index, including coverage and freshness. Managed requests accept the compact total-jobs and freshness format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Search Stats
>
> **Slug:** `LEADMAGIC_GET_SEARCH_STATS`
>
> Return 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
>
> **limit** `integer`
>
> Maximum top values per dimension (1-10).
>
> **products** `array`
>
> Search products whose stats to request.
>
> **sections** `array`
>
> Stat sections to request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Batch Clients
>
> **Slug:** `LEADMAGIC_LIST_BATCH_CLIENTS`
>
> List 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Batch Client Webhooks
>
> **Slug:** `LEADMAGIC_LIST_BATCH_CLIENT_WEBHOOKS`
>
> List delivery webhooks configured for one batch client using your own LeadMagic API key. This read does not create, change, or invoke webhooks.
>
> #### Input Parameters
>
> **client\_id** `string` *required*
>
> UUID of the batch client whose delivery webhooks should be listed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Batches
>
> **Slug:** `LEADMAGIC_LIST_BATCHES`
>
> List 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
>
> **limit** `integer`
>
> Maximum batches to return (1-200).
>
> **offset** `integer`
>
> Zero-based result offset. Use next\_offset from the prior response to continue.
>
> **status** `string`
>
> Filter batches by provider batch status.
>
> **product** `string`
>
> Filter batches by enrichment product.
>
> **client\_id** `string`
>
> Filter batches by associated client identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Bulk Job Errors
>
> **Slug:** `LEADMAGIC_LIST_BULK_JOB_ERRORS`
>
> Check 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
>
> **limit** `integer`
>
> Maximum failed rows to return in this page (1-1000).
>
> **job\_id** `string` *required*
>
> UUID of a bulk job owned by the connected workspace, normally captured from Submit Bulk Job in the same workflow.
>
> **offset** `integer`
>
> Zero-based failed-row offset for this page (0-1000000).
>
> **status** `string`
>
> Optional provider status value used to filter failed rows.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Bulk Job Events
>
> **Slug:** `LEADMAGIC_LIST_BULK_JOB_EVENTS`
>
> Return 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
>
> **limit** `integer`
>
> Maximum append-only events to return, newest first (1-2000).
>
> **job\_id** `string` *required*
>
> UUID of a bulk job owned by the connected workspace, normally captured from Submit Bulk Job in the same workflow.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Bulk Job Results
>
> **Slug:** `LEADMAGIC_LIST_BULK_JOB_RESULTS`
>
> Return 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
>
> **limit** `integer`
>
> Maximum rows in this page (1-1000).
>
> **job\_id** `string` *required*
>
> UUID captured from a bulk job created by this workflow.
>
> **offset** `integer`
>
> Zero-based row offset for this page.
>
> **status** `string`
>
> Optional row-status filter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Bulk Jobs
>
> **Slug:** `LEADMAGIC_LIST_BULK_JOBS`
>
> Return 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
>
> **limit** `integer`
>
> Number of jobs in this page (1-200).
>
> **offset** `integer`
>
> Number of jobs to skip (0-10000). Pass next\_offset to continue.
>
> **status** `string`
>
> Filter jobs by current status.
>
> **product** `string`
>
> Filter jobs by enrichment product.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Credit Budgets
>
> **Slug:** `LEADMAGIC_LIST_CREDIT_BUDGETS`
>
> List credit budgets configured for the connected LeadMagic workspace, including their identifiers. Managed access is not qualified; use a connected API key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Email Suppression Lists
>
> **Slug:** `LEADMAGIC_LIST_EMAIL_SUPPRESSION_LISTS`
>
> Read 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List External Batch Providers
>
> **Slug:** `LEADMAGIC_LIST_EXTERNAL_BATCH_PROVIDERS`
>
> List organization-level external enrichment provider configurations. This action is unavailable with managed credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Job Company Types V1
>
> **Slug:** `LEADMAGIC_LIST_JOB_COMPANY_TYPES_V1`
>
> List company type IDs for the legacy V1 Jobs Finder API. This action is unavailable with managed credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Job Countries V1
>
> **Slug:** `LEADMAGIC_LIST_JOB_COUNTRIES_V1`
>
> List country codes for the legacy V1 Jobs Finder API. This action is unavailable with managed credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Job Industries V1
>
> **Slug:** `LEADMAGIC_LIST_JOB_INDUSTRIES_V1`
>
> List industry IDs for the legacy V1 Jobs Finder API. This action is unavailable with managed credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Job Occupation Taxonomy V3
>
> **Slug:** `LEADMAGIC_LIST_JOB_OCCUPATION_TAXONOMY_V3`
>
> Autocomplete LeadMagic's broad-to-specific occupation taxonomy and return canonical IDs, labels, levels, and paths. This helper is free.
>
> #### Input Parameters
>
> **level** `string ("level1" | "level2" | "level3")`
>
> Restrict results to a broad family, category, or normalized title level.
>
> **limit** `integer`
>
> Number of taxonomy entries to return.
>
> **query** `string`
>
> Free-text occupation query.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Job Regions V1
>
> **Slug:** `LEADMAGIC_LIST_JOB_REGIONS_V1`
>
> List region IDs for the legacy V1 Jobs Finder API. This action is unavailable with managed credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Job Search Company Suggestions V3
>
> **Slug:** `LEADMAGIC_LIST_JOB_SEARCH_COMPANY_SUGGESTIONS_V3`
>
> Autocomplete companies or resolve an exact domain into canonical company IDs and card data for Job Search filters. This helper is free.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of company candidates to return.
>
> **query** `string`
>
> Free-text company name or domain to match.
>
> **domain** `string`
>
> Exact company domain to look up.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Job Search Location Suggestions V3
>
> **Slug:** `LEADMAGIC_LIST_JOB_SEARCH_LOCATION_SUGGESTIONS_V3`
>
> Autocomplete countries, regions, states, and cities into canonical IDs for exact Job Search geo filters. This helper is free.
>
> #### Input Parameters
>
> **type** `string ("country" | "region" | "state" | "city")`
>
> Location type to search: country, region, state, or city.
>
> **limit** `integer`
>
> Number of location candidates to return.
>
> **query** `string`
>
> Free-text country, region, state, or city query.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Job Search Role Suggestions V3
>
> **Slug:** `LEADMAGIC_LIST_JOB_SEARCH_ROLE_SUGGESTIONS_V3`
>
> Autocomplete role names into canonical occupation taxonomy IDs for Job Search filters. This helper is free.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of role candidates to return.
>
> **query** `string`
>
> Free-text role query.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Job Search Tag Suggestions V3
>
> **Slug:** `LEADMAGIC_LIST_JOB_SEARCH_TAG_SUGGESTIONS_V3`
>
> Autocomplete normalized job tags with tag-type and occupation taxonomy metadata for Job Search filters. This helper is free.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of tag candidates to return.
>
> **query** `string`
>
> Free-text tag query, such as a tool, platform, or skill prefix.
>
> **tag\_type** `integer`
>
> Optional tag-type ID used to restrict suggestions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Job Search Title Suggestions V3
>
> **Slug:** `LEADMAGIC_LIST_JOB_SEARCH_TITLE_SUGGESTIONS_V3`
>
> Autocomplete searchable job title phrases with occupation taxonomy metadata for Job Search filters. This helper is free.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of title candidates to return.
>
> **query** `string`
>
> Free-text job title query.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Job Types V1
>
> **Slug:** `LEADMAGIC_LIST_JOB_TYPES_V1`
>
> List job type IDs for the legacy V1 Jobs Finder API using your own LeadMagic connection. Returns reference data only.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Lookup Company Domain V3 Docs Alias
>
> **Slug:** `LEADMAGIC_LOOKUP_COMPANY_DOMAIN_V3_DOCS_ALIAS`
>
> Look up companies through POST /v3/companies/domain-lookup using your own LeadMagic connection, returning one cursor-controlled page. Calls may incur charges.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum companies on this page (1-50). This does not fetch later pages.
>
> **query** `string`
>
> Free-text company search query.
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
>
> **domain** `string`
>
> Documented alias for company\_domain.
>
> **offset** `integer`
>
> Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
>
> **website** `string`
>
> Company website URL or domain.
>
> **profile\_url** `string`
>
> Professional company profile URL.
>
> **company\_name** `string`
>
> Company name to look up or search.
>
> **linkedin\_url** `string`
>
> Documented alias for a professional company profile URL.
>
> **company\_domain** `string`
>
> Direct one-company lookup domain, such as example.com.
>
> **company\_filters** `object`
>
> Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Lookup Company V3 Docs Alias
>
> **Slug:** `LEADMAGIC_LOOKUP_COMPANY_V3_DOCS_ALIAS`
>
> Look up companies through POST /v3/companies/lookup using your own LeadMagic connection, returning one cursor-controlled page. Calls may incur charges.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum companies on this page (1-50). This does not fetch later pages.
>
> **query** `string`
>
> Free-text company search query.
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
>
> **domain** `string`
>
> Documented alias for company\_domain.
>
> **offset** `integer`
>
> Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
>
> **website** `string`
>
> Company website URL or domain.
>
> **profile\_url** `string`
>
> Professional company profile URL.
>
> **company\_name** `string`
>
> Company name to look up or search.
>
> **linkedin\_url** `string`
>
> Documented alias for a professional company profile URL.
>
> **company\_domain** `string`
>
> Direct one-company lookup domain, such as example.com.
>
> **company\_filters** `object`
>
> Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Pause Bulk Job
>
> **Slug:** `LEADMAGIC_PAUSE_BULK_JOB`
>
> Pause a queued or running LeadMagic bulk job owned by the connected workspace, changing its processing state. Managed access is not available.
>
> #### Input Parameters
>
> **job\_id** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Preview Mixed Batch Cost
>
> **Slug:** `LEADMAGIC_PREVIEW_MIXED_BATCH_COST`
>
> Estimate 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
>
> **items** `array` *required*
>
> One to 10,000 batch items to estimate without submitting work.
>
> **metadata** `object`
>
> Optional metadata for the whole preview.
>
> **client\_id** `string`
>
> Optional client identifier for the whole preview.
>
> **client\_name** `string`
>
> Optional client name for the whole preview.
>
> **budget\_user\_id** `string`
>
> User ID whose configured credit budget should be checked by the preview.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Refresh Credit Cache V1 Docs Only
>
> **Slug:** `LEADMAGIC_REFRESH_CREDIT_CACHE_V1_DOCS_ONLY`
>
> Request 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Emails From Suppression List
>
> **Slug:** `LEADMAGIC_REMOVE_EMAILS_FROM_SUPPRESSION_LIST`
>
> Remove 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
>
> **emails** `array` *required*
>
> Non-empty plaintext email list to unsuppress. Each address must be the exact lifecycle-owned value previously added to this list.
>
> **list\_id** `string` *required*
>
> Exact suppression-list identifier captured from Create Email Suppression List in the same owned lifecycle.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Resolve Job Search Filters V3
>
> **Slug:** `LEADMAGIC_RESOLVE_JOB_SEARCH_FILTERS_V3`
>
> Resolve 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
>
> **tags** `object`
>
> Job tags to resolve.
>
> **titles** `object`
>
> Title filters to resolve.
>
> **location** `object`
>
> Location filters to resolve.
>
> **companies** `object`
>
> Company filters to resolve.
>
> **occupation\_taxonomy** `object`
>
> Occupation taxonomy filters sent under the exact occupationTaxonomy key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Restart Bulk Job
>
> **Slug:** `LEADMAGIC_RESTART_BULK_JOB`
>
> Destructively 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
>
> **mode** `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.
>
> **job\_id** `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.
>
> **start\_row\_index** `integer`
>
> Zero-based row index; required only when mode is from\_row.
>
> **start\_shard\_index** `integer`
>
> Zero-based shard index; required only when mode is from\_shard.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Resume Bulk Job
>
> **Slug:** `LEADMAGIC_RESUME_BULK_JOB`
>
> Resume 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
>
> **job\_id** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Review Bulk Job
>
> **Slug:** `LEADMAGIC_REVIEW_BULK_JOB`
>
> Resume 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
>
> **action** `string ("approve" | "reject")` *required*
>
> approve resumes a paused job; reject cancels a queued or processing job.
>
> **job\_id** `string` *required*
>
> UUID captured from a bulk job created by this workflow.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search B2B Ads V1
>
> **Slug:** `LEADMAGIC_SEARCH_B2B_ADS_V1`
>
> Search 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
>
> **limit** `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.
>
> **company\_name** `string`
>
> Company name to search. Provide this or company\_domain.
>
> **company\_domain** `string`
>
> Company domain to search. Provide this or company\_name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Companies
>
> **Slug:** `LEADMAGIC_SEARCH_COMPANIES`
>
> Search 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
>
> **limit** `integer`
>
> Maximum companies in this page (1-50). Each search costs 1 credit, whatever the page size.
>
> **query** `string`
>
> A free-text company search query.
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous response. Pass it unchanged; the original criteria and limit are retained by the cursor.
>
> **domain** `string`
>
> Alias for company\_domain accepted by LeadMagic.
>
> **offset** `integer`
>
> Legacy result offset. Prefer cursor pagination; restart at offset 0 to obtain a stable cursor.
>
> **website** `string`
>
> A company website URL or domain.
>
> **profile\_url** `string`
>
> A professional company profile URL.
>
> **company\_name** `string`
>
> A company name to look up or search.
>
> **linkedin\_url** `string`
>
> Alias for profile\_url accepted by LeadMagic.
>
> **company\_domain** `string`
>
> A bare domain for a direct company lookup.
>
> **company\_filters** `object`
>
> Structured filters for company identity, firmographics, geography, funding, contact coverage, web presence, and technologies.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Companies V1 Legacy Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_COMPANIES_V1_LEGACY_DOCS_ALIAS`
>
> Search companies through the legacy POST /v1/companies/search compatibility route, returning one cursor-controlled page. This action is unavailable with managed credentials.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum companies on this page (1-50). This does not fetch later pages.
>
> **query** `string`
>
> Free-text company search query.
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
>
> **domain** `string`
>
> Documented alias for company\_domain.
>
> **offset** `integer`
>
> Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
>
> **website** `string`
>
> Company website URL or domain.
>
> **profile\_url** `string`
>
> Professional company profile URL.
>
> **company\_name** `string`
>
> Company name to look up or search.
>
> **linkedin\_url** `string`
>
> Documented alias for a professional company profile URL.
>
> **company\_domain** `string`
>
> Direct one-company lookup domain, such as example.com.
>
> **company\_filters** `object`
>
> Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Companies V3 Company Hyphenated Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_COMPANIES_V3_COMPANY_HYPHENATED_DOCS_ALIAS`
>
> Search companies through POST /v3/companies/company-search, returning one cursor-controlled page. This action is unavailable with managed credentials.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum companies on this page (1-50). This does not fetch later pages.
>
> **query** `string`
>
> Free-text company search query.
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous response. Pass it unchanged; the original criteria and limit are restored safely.
>
> **domain** `string`
>
> Documented alias for company\_domain.
>
> **offset** `integer`
>
> Legacy unstable offset. Prefer cursor pagination; use offset 0 when starting or continuing a cursor search.
>
> **website** `string`
>
> Company website URL or domain.
>
> **profile\_url** `string`
>
> Professional company profile URL.
>
> **company\_name** `string`
>
> Company name to look up or search.
>
> **linkedin\_url** `string`
>
> Documented alias for a professional company profile URL.
>
> **company\_domain** `string`
>
> Direct one-company lookup domain, such as example.com.
>
> **company\_filters** `object`
>
> Typed company filters for identity, firmographics, geography, funding, contact coverage, web presence, and technologies. Unset fields are omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Google Ads V1
>
> **Slug:** `LEADMAGIC_SEARCH_GOOGLE_ADS_V1`
>
> Search 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
>
> **limit** `integer`
>
> Maximum ads to return (1-100). Each returned ad costs 1 credit, so this caps the price. Defaults to 1.
>
> **company\_name** `string`
>
> Company name to search. Provide this or company\_domain.
>
> **company\_domain** `string`
>
> Company domain to search. Provide this or company\_name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Jobs
>
> **Slug:** `LEADMAGIC_SEARCH_JOBS`
>
> Search 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
>
> **mode** `string ("fast" | "deep")`
>
> Use fast for normal browsing; deep enables broader text matching.
>
> **tags** `object`
>
> Job tag criteria using names or canonical IDs.
>
> **limit** `integer`
>
> Maximum jobs in this page (1-5). Each returned job costs 1 credit.
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous response. Pass it unchanged; the original filters and limit are retained by the cursor.
>
> **salary** `object`
>
> Normalized annual salary bounds in USD.
>
> **titles** `object`
>
> Title criteria with include and exclude terms and optional vector matching.
>
> **location** `object`
>
> Location criteria using country, region, state, and city values.
>
> **companies** `object`
>
> Company criteria using names, domains, or canonical numeric IDs.
>
> **seniority** `array`
>
> Seniority labels to include, such as EN, MI, SE, or EX.
>
> **remote\_only** `boolean`
>
> When true, require jobs marked as supporting remote work.
>
> **posted\_after** `string`
>
> Only include jobs posted on or after this YYYY-MM-DD date.
>
> **posted\_before** `string`
>
> Only include jobs posted on or before this YYYY-MM-DD date.
>
> **posted\_within\_days** `integer`
>
> Only include jobs posted within the last N days.
>
> **include\_description** `boolean`
>
> Include job description text; this can increase latency and response size.
>
> **occupation\_taxonomy** `object`
>
> Occupation taxonomy filters grouped into level1, level2, and level3.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Jobs V1 Legacy Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_JOBS_V1_LEGACY_DOCS_ALIAS`
>
> Search jobs through POST /v1/jobs/search using your own LeadMagic connection, returning one cursor page. Each search costs 1 credit.
>
> #### Input Parameters
>
> **mode** `string ("fast" | "deep")`
>
> fast browses normally; deep enables broader text matching.
>
> **tags** `object`
>
> Job tag filters.
>
> **limit** `integer`
>
> Maximum jobs in this page (1-50).
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous page; pass it unchanged.
>
> **salary** `object`
>
> Salary filters in USD.
>
> **titles** `object`
>
> Job title filters.
>
> **location** `object`
>
> Location filters.
>
> **companies** `object`
>
> Company filters.
>
> **languages** `array`
>
> Job languages to include.
>
> **seniority** `array`
>
> Seniority codes to include.
>
> **has\_remote** `boolean`
>
> Whether to require jobs supporting remote work.
>
> **total\_mode** `string ("none" | "capped" | "exact")`
>
> Count mode for the result total.
>
> **auto\_resolve** `boolean`
>
> Resolve friendly filter values to canonical IDs.
>
> **industry\_ids** `array`
>
> Industry IDs from the V1 industry catalog.
>
> **job\_type\_ids** `array`
>
> Job type IDs from the V1 job type catalog.
>
> **posted\_after** `string`
>
> Only include jobs posted on or after this date.
>
> **posted\_before** `string`
>
> Only include jobs posted on or before this date.
>
> **posted\_within** `integer`
>
> Only include jobs posted within the last N days.
>
> **include\_facets** `boolean`
>
> Include facet metadata; this may increase response time.
>
> **company\_type\_ids** `array`
>
> Company type IDs from the V1 company type catalog.
>
> **company\_size\_codes** `array`
>
> Company size codes to include.
>
> **include\_description** `boolean`
>
> Include job descriptions; this may increase response time.
>
> **occupation\_taxonomy** `object`
>
> Occupation taxonomy filters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Jobs V2 Legacy Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_JOBS_V2_LEGACY_DOCS_ALIAS`
>
> Search jobs through POST /v2/jobs/search using your own LeadMagic connection, returning one cursor page. Each search costs 1 credit.
>
> #### Input Parameters
>
> **mode** `string ("fast" | "deep")`
>
> fast browses normally; deep enables broader text matching.
>
> **tags** `object`
>
> Job tag filters.
>
> **limit** `integer`
>
> Maximum jobs in this page (1-50).
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous page; pass it unchanged.
>
> **salary** `object`
>
> Salary filters in USD.
>
> **titles** `object`
>
> Job title filters.
>
> **location** `object`
>
> Location filters.
>
> **companies** `object`
>
> Company filters.
>
> **languages** `array`
>
> Job languages to include.
>
> **seniority** `array`
>
> Seniority codes to include.
>
> **has\_remote** `boolean`
>
> Whether to require jobs supporting remote work.
>
> **total\_mode** `string ("none" | "capped" | "exact")`
>
> Count mode for the result total.
>
> **auto\_resolve** `boolean`
>
> Resolve friendly filter values to canonical IDs.
>
> **industry\_ids** `array`
>
> Industry IDs from the V1 industry catalog.
>
> **job\_type\_ids** `array`
>
> Job type IDs from the V1 job type catalog.
>
> **posted\_after** `string`
>
> Only include jobs posted on or after this date.
>
> **posted\_before** `string`
>
> Only include jobs posted on or before this date.
>
> **posted\_within** `integer`
>
> Only include jobs posted within the last N days.
>
> **include\_facets** `boolean`
>
> Include facet metadata; this may increase response time.
>
> **company\_type\_ids** `array`
>
> Company type IDs from the V1 company type catalog.
>
> **company\_size\_codes** `array`
>
> Company size codes to include.
>
> **include\_description** `boolean`
>
> Include job descriptions; this may increase response time.
>
> **occupation\_taxonomy** `object`
>
> Occupation taxonomy filters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Jobs V3 Hyphenated OpenAPI Alias
>
> **Slug:** `LEADMAGIC_SEARCH_JOBS_V3_HYPHENATED_OPENAPI_ALIAS`
>
> Search 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
>
> **mode** `string ("fast" | "deep")`
>
> Search execution mode.
>
> **tags** `object`
>
> Tag filter criteria.
>
> **limit** `integer`
>
> Jobs in this page (1-5). Each returned job costs 1 credit.
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous page; pass it unchanged.
>
> **titles** `object`
>
> Title search criteria.
>
> **location** `object`
>
> Country filter criteria.
>
> **total\_mode** `string ("none" | "capped" | "exact")`
>
> Count mode sent as the exact totalMode body key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Jobs V3 Singular Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_JOBS_V3_SINGULAR_DOCS_ALIAS`
>
> Search jobs through POST /v3/job-search using your own LeadMagic connection, returning one cursor page. Search pricing depends on the plan.
>
> #### Input Parameters
>
> **mode** `string ("fast" | "deep")`
>
> fast browses normally; deep enables broader text matching.
>
> **tags** `object`
>
> Job tag filters.
>
> **limit** `integer`
>
> Maximum jobs in this page (1-50).
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous page; pass it unchanged.
>
> **salary** `object`
>
> Salary filters in USD.
>
> **titles** `object`
>
> Job title filters.
>
> **location** `object`
>
> Location filters.
>
> **companies** `object`
>
> Company filters.
>
> **languages** `array`
>
> Job languages to include.
>
> **seniority** `array`
>
> Seniority codes to include.
>
> **has\_remote** `boolean`
>
> Whether to require jobs supporting remote work.
>
> **total\_mode** `string ("none" | "capped" | "exact")`
>
> Count mode for the result total.
>
> **auto\_resolve** `boolean`
>
> Resolve friendly filter values to canonical IDs.
>
> **industry\_ids** `array`
>
> Industry IDs from the V1 industry catalog.
>
> **job\_type\_ids** `array`
>
> Job type IDs from the V1 job type catalog.
>
> **posted\_after** `string`
>
> Only include jobs posted on or after this date.
>
> **posted\_before** `string`
>
> Only include jobs posted on or before this date.
>
> **posted\_within** `integer`
>
> Only include jobs posted within the last N days.
>
> **include\_facets** `boolean`
>
> Include facet metadata; this may increase response time.
>
> **company\_type\_ids** `array`
>
> Company type IDs from the V1 company type catalog.
>
> **company\_size\_codes** `array`
>
> Company size codes to include.
>
> **include\_description** `boolean`
>
> Include job descriptions; this may increase response time.
>
> **occupation\_taxonomy** `object`
>
> Occupation taxonomy filters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Meta Ads V1
>
> **Slug:** `LEADMAGIC_SEARCH_META_ADS_V1`
>
> Search 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
>
> **limit** `integer`
>
> Maximum ads to return (1-100). Each returned ad costs 1 credit, so this caps the price. Defaults to 1.
>
> **company\_name** `string`
>
> Company name to search. Provide this or company\_domain.
>
> **company\_domain** `string`
>
> Company domain to search. Provide this or company\_name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People
>
> **Slug:** `LEADMAGIC_SEARCH_PEOPLE`
>
> Search 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
>
> **limit** `integer`
>
> Maximum people in this page (1-10). Each returned person costs 1 credit.
>
> **query** `string`
>
> Free-text person or title query.
>
> **roles** `array`
>
> Role or function labels to match.
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous response. Pass it unchanged; the original filters and limit are retained by the cursor.
>
> **job\_titles** `array`
>
> Job titles to match; values within this list are alternatives.
>
> **company\_name** `string`
>
> Limit results to a company name when the domain is unknown.
>
> **company\_domain** `string`
>
> Limit results to a company domain.
>
> **require\_email\_available** `boolean`
>
> Only return people for whom email availability is known; this does not unlock or return the raw email.
>
> **require\_mobile\_available** `boolean`
>
> Only return people for whom mobile availability is known; this does not unlock or return the raw number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People V1 Legacy Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_PEOPLE_V1_LEGACY_DOCS_ALIAS`
>
> Search 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
>
> **limit** `integer`
>
> Maximum people in this page (1-10); each returned person costs 1 credit.
>
> **query** `string`
>
> Free-text people or title query.
>
> **roles** `array`
>
> Role or function labels to match.
>
> **title** `string`
>
> Single title filter.
>
> **cursor** `string`
>
> Opaque continuation cursor; pass it unchanged without repeating filters.
>
> **titles** `array`
>
> Job titles to match as alternatives.
>
> **channels** `array`
>
> Legacy contactability availability requirements.
>
> **job\_title** `string`
>
> Legacy single job-title filter.
>
> **company\_name** `string`
>
> Company name search anchor.
>
> **linkedin\_url** `string`
>
> B2B company profile URL or slug search anchor.
>
> **channel\_match** `string ("any" | "all")`
>
> Whether any or all requested channels must be available.
>
> **company\_domain** `string`
>
> Company domain search anchor.
>
> **people\_filters** `object`
>
> People filters; list values are ORed and different keys are ANDed.
>
> **required\_email** `boolean`
>
> Require known email availability without returning the raw email.
>
> **company\_filters** `object`
>
> Criteria-based company search anchor using Company Search filters.
>
> **include\_company** `boolean`
>
> Include base company data with each person.
>
> **required\_mobile** `boolean`
>
> Require known mobile availability without returning the raw number.
>
> **include\_domain\_intel** `boolean`
>
> Include base domain intelligence with each person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People V2 Legacy Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_PEOPLE_V2_LEGACY_DOCS_ALIAS`
>
> Search 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
>
> **limit** `integer`
>
> Maximum people in this page (1-10); each returned person costs 1 credit.
>
> **query** `string`
>
> Free-text people or title query.
>
> **roles** `array`
>
> Role or function labels to match.
>
> **title** `string`
>
> Single title filter.
>
> **cursor** `string`
>
> Opaque continuation cursor; pass it unchanged without repeating filters.
>
> **titles** `array`
>
> Job titles to match as alternatives.
>
> **channels** `array`
>
> Legacy contactability availability requirements.
>
> **job\_title** `string`
>
> Legacy single job-title filter.
>
> **company\_name** `string`
>
> Company name search anchor.
>
> **linkedin\_url** `string`
>
> B2B company profile URL or slug search anchor.
>
> **channel\_match** `string ("any" | "all")`
>
> Whether any or all requested channels must be available.
>
> **company\_domain** `string`
>
> Company domain search anchor.
>
> **people\_filters** `object`
>
> People filters; list values are ORed and different keys are ANDed.
>
> **required\_email** `boolean`
>
> Require known email availability without returning the raw email.
>
> **company\_filters** `object`
>
> Criteria-based company search anchor using Company Search filters.
>
> **include\_company** `boolean`
>
> Include base company data with each person.
>
> **required\_mobile** `boolean`
>
> Require known mobile availability without returning the raw number.
>
> **include\_domain\_intel** `boolean`
>
> Include base domain intelligence with each person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People V3 By Title Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_PEOPLE_V3_BY_TITLE_DOCS_ALIAS`
>
> Search 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
>
> **limit** `integer`
>
> Maximum people in this page (1-10); each returned person costs 1 credit.
>
> **query** `string`
>
> Free-text people or title query.
>
> **roles** `array`
>
> Role or function labels to match.
>
> **title** `string`
>
> Single title filter.
>
> **cursor** `string`
>
> Opaque continuation cursor; pass it unchanged without repeating filters.
>
> **titles** `array`
>
> Job titles to match as alternatives.
>
> **channels** `array`
>
> Legacy contactability availability requirements.
>
> **job\_title** `string`
>
> Legacy single job-title filter.
>
> **company\_name** `string`
>
> Company name search anchor.
>
> **linkedin\_url** `string`
>
> B2B company profile URL or slug search anchor.
>
> **channel\_match** `string ("any" | "all")`
>
> Whether any or all requested channels must be available.
>
> **company\_domain** `string`
>
> Company domain search anchor.
>
> **people\_filters** `object`
>
> People filters; list values are ORed and different keys are ANDed.
>
> **required\_email** `boolean`
>
> Require known email availability without returning the raw email.
>
> **company\_filters** `object`
>
> Criteria-based company search anchor using Company Search filters.
>
> **include\_company** `boolean`
>
> Include base company data with each person.
>
> **required\_mobile** `boolean`
>
> Require known mobile availability without returning the raw number.
>
> **include\_domain\_intel** `boolean`
>
> Include base domain intelligence with each person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People V3 Company Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_PEOPLE_V3_COMPANY_DOCS_ALIAS`
>
> Search people through POST /v3/people/company-search, returning one cursor page without requesting raw contact details. Managed access is not available.
>
> #### Input Parameters
>
> **limit** `integer`
>
> People to return on this cursor page (1-10), charged per returned person.
>
> **query** `string`
>
> Free-text people or title query.
>
> **roles** `array`
>
> Role or function labels to match.
>
> **title** `string`
>
> Single job title to match.
>
> **cursor** `string`
>
> Opaque next\_cursor from the prior page. Pass unchanged; filters are retained.
>
> **titles** `array`
>
> Job titles to match as alternatives.
>
> **channels** `array`
>
> Legacy contact-availability requirements.
>
> **job\_title** `string`
>
> Legacy single job-title filter.
>
> **company\_name** `string`
>
> Company name to search.
>
> **linkedin\_url** `string`
>
> Professional company profile URL or slug.
>
> **channel\_match** `string ("any" | "all")`
>
> Whether any or all requested channels must be available.
>
> **company\_domain** `string`
>
> Company domain to search.
>
> **people\_filters** `object`
>
> People-level filters. Different keys are ANDed; array values are alternatives.
>
> **required\_email** `boolean`
>
> Require known email availability; raw email is never unlocked.
>
> **company\_filters** `object`
>
> Documented Company Search filters defining the company set.
>
> **include\_company** `boolean`
>
> Include base company data with each person.
>
> **required\_mobile** `boolean`
>
> Require known mobile availability; raw numbers are never unlocked.
>
> **include\_domain\_intel** `boolean`
>
> Include base domain intelligence with each person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People V3 Contacts By Title Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_PEOPLE_V3_CONTACTS_BY_TITLE_DOCS_ALIAS`
>
> Search 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
>
> **limit** `integer`
>
> Maximum people in this page (1-10); each returned person costs 1 credit.
>
> **query** `string`
>
> Free-text people or title query.
>
> **roles** `array`
>
> Role or function labels to match.
>
> **title** `string`
>
> Single title filter.
>
> **cursor** `string`
>
> Opaque continuation cursor; pass it unchanged without repeating filters.
>
> **titles** `array`
>
> Job titles to match as alternatives.
>
> **channels** `array`
>
> Legacy contactability availability requirements.
>
> **job\_title** `string`
>
> Legacy single job-title filter.
>
> **company\_name** `string`
>
> Company name search anchor.
>
> **linkedin\_url** `string`
>
> B2B company profile URL or slug search anchor.
>
> **channel\_match** `string ("any" | "all")`
>
> Whether any or all requested channels must be available.
>
> **company\_domain** `string`
>
> Company domain search anchor.
>
> **people\_filters** `object`
>
> People filters; list values are ORed and different keys are ANDed.
>
> **required\_email** `boolean`
>
> Require known email availability without returning the raw email.
>
> **company\_filters** `object`
>
> Criteria-based company search anchor using Company Search filters.
>
> **include\_company** `boolean`
>
> Include base company data with each person.
>
> **required\_mobile** `boolean`
>
> Require known mobile availability without returning the raw number.
>
> **include\_domain\_intel** `boolean`
>
> Include base domain intelligence with each person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People V3 Employees Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_PEOPLE_V3_EMPLOYEES_DOCS_ALIAS`
>
> Search people through POST /v3/people/employees, returning one base-only cursor page without requesting raw contact details. Managed access is not available.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum people in this page (1-10); each returned person costs 1 credit.
>
> **query** `string`
>
> Free-text people or title query.
>
> **roles** `array`
>
> Role or function labels to match.
>
> **title** `string`
>
> Single title filter.
>
> **cursor** `string`
>
> Opaque continuation cursor; pass it unchanged without repeating filters.
>
> **titles** `array`
>
> Job titles to match as alternatives.
>
> **channels** `array`
>
> Legacy contactability availability requirements.
>
> **job\_title** `string`
>
> Legacy single job-title filter.
>
> **company\_name** `string`
>
> Company name search anchor.
>
> **linkedin\_url** `string`
>
> B2B company profile URL or slug search anchor.
>
> **channel\_match** `string ("any" | "all")`
>
> Whether any or all requested channels must be available.
>
> **company\_domain** `string`
>
> Company domain search anchor.
>
> **people\_filters** `object`
>
> People filters; list values are ORed and different keys are ANDed.
>
> **required\_email** `boolean`
>
> Require known email availability without returning the raw email.
>
> **company\_filters** `object`
>
> Criteria-based company search anchor using Company Search filters.
>
> **include\_company** `boolean`
>
> Include base company data with each person.
>
> **required\_mobile** `boolean`
>
> Require known mobile availability without returning the raw number.
>
> **include\_domain\_intel** `boolean`
>
> Include base domain intelligence with each person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People V3 Full Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_PEOPLE_V3_FULL_DOCS_ALIAS`
>
> Search 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
>
> **limit** `integer`
>
> People to return on this cursor page (1-10), each returned person costs 1 credit.
>
> **query** `string`
>
> Free-text people or title query.
>
> **roles** `array`
>
> Role or function labels to match.
>
> **title** `string`
>
> Single job title to match.
>
> **cursor** `string`
>
> Opaque next\_cursor from the prior page. Pass unchanged; filters are retained.
>
> **titles** `array`
>
> Job titles to match as alternatives.
>
> **channels** `array`
>
> Legacy contact-availability requirements.
>
> **job\_title** `string`
>
> Legacy single job-title filter.
>
> **company\_name** `string`
>
> Company name to search.
>
> **linkedin\_url** `string`
>
> Professional company profile URL or slug.
>
> **channel\_match** `string ("any" | "all")`
>
> Whether any or all requested channels must be available.
>
> **company\_domain** `string`
>
> Company domain to search.
>
> **people\_filters** `object`
>
> People-level filters. Different keys are ANDed; array values are alternatives.
>
> **required\_email** `boolean`
>
> Require known email availability; raw email is never unlocked.
>
> **company\_filters** `object`
>
> Documented Company Search filters defining the company set.
>
> **include\_company** `boolean`
>
> Include base company data with each person.
>
> **required\_mobile** `boolean`
>
> Require known mobile availability; raw numbers are never unlocked.
>
> **include\_domain\_intel** `boolean`
>
> Include base domain intelligence with each person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People V3 Icp Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_PEOPLE_V3_ICP_DOCS_ALIAS`
>
> Search 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
>
> **limit** `integer`
>
> Maximum people in this cursor page (1-10). Each returned person costs 1 credit; zero-result pages are free.
>
> **query** `string`
>
> Free-text people or title query.
>
> **roles** `array`
>
> Role or function labels to match.
>
> **title** `string`
>
> Single title filter.
>
> **cursor** `string`
>
> Opaque next\_cursor from the previous response. Pass it unchanged; all original filters and the limit are retained.
>
> **titles** `array`
>
> Job titles to match as alternatives.
>
> **channels** `array`
>
> Legacy contactability requirements; checks availability only.
>
> **job\_title** `string`
>
> Legacy single job-title filter.
>
> **company\_name** `string`
>
> Company name that anchors the search when no domain is known.
>
> **linkedin\_url** `string`
>
> B2B company profile URL or slug that anchors the search.
>
> **channel\_match** `string ("any" | "all")`
>
> Whether any or all requested channels must be available.
>
> **company\_domain** `string`
>
> Company domain that anchors the people search.
>
> **people\_filters** `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.
>
> **required\_email** `boolean`
>
> Only return people with known email availability; no raw email is returned.
>
> **company\_filters** `object`
>
> Criteria-based company set using the documented Company Search filters.
>
> **include\_company** `boolean`
>
> Include base company data with each person.
>
> **required\_mobile** `boolean`
>
> Only return people with known mobile availability; no raw number is returned.
>
> **include\_domain\_intel** `boolean`
>
> Include base domain intelligence with each person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People V3 Lookalike Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_PEOPLE_V3_LOOKALIKE_DOCS_ALIAS`
>
> Search people through POST /v3/people/lookalike, returning one base-only cursor page without requesting raw contact details. Managed access is not available.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum people in this page (1-10); each returned person costs 1 credit.
>
> **query** `string`
>
> Free-text people or title query.
>
> **roles** `array`
>
> Role or function labels to match.
>
> **title** `string`
>
> Single title filter.
>
> **cursor** `string`
>
> Opaque continuation cursor; pass it unchanged without repeating filters.
>
> **titles** `array`
>
> Job titles to match as alternatives.
>
> **channels** `array`
>
> Legacy contactability availability requirements.
>
> **job\_title** `string`
>
> Legacy single job-title filter.
>
> **company\_name** `string`
>
> Company name search anchor.
>
> **linkedin\_url** `string`
>
> B2B company profile URL or slug search anchor.
>
> **channel\_match** `string ("any" | "all")`
>
> Whether any or all requested channels must be available.
>
> **company\_domain** `string`
>
> Company domain search anchor.
>
> **people\_filters** `object`
>
> People filters; list values are ORed and different keys are ANDed.
>
> **required\_email** `boolean`
>
> Require known email availability without returning the raw email.
>
> **company\_filters** `object`
>
> Criteria-based company search anchor using Company Search filters.
>
> **include\_company** `boolean`
>
> Include base company data with each person.
>
> **required\_mobile** `boolean`
>
> Require known mobile availability without returning the raw number.
>
> **include\_domain\_intel** `boolean`
>
> Include base domain intelligence with each person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People V3 Mixed Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_PEOPLE_V3_MIXED_DOCS_ALIAS`
>
> Search people through POST /v3/people/mixed-search, returning one cursor page without requesting raw contact details. Managed access is not available.
>
> #### Input Parameters
>
> **limit** `integer`
>
> People to return on this cursor page (1-10), charged per returned person.
>
> **query** `string`
>
> Free-text people or title query.
>
> **roles** `array`
>
> Role or function labels to match.
>
> **title** `string`
>
> Single job title to match.
>
> **cursor** `string`
>
> Opaque next\_cursor from the prior page. Pass unchanged; filters are retained.
>
> **titles** `array`
>
> Job titles to match as alternatives.
>
> **channels** `array`
>
> Legacy contact-availability requirements.
>
> **job\_title** `string`
>
> Legacy single job-title filter.
>
> **company\_name** `string`
>
> Company name to search.
>
> **linkedin\_url** `string`
>
> Professional company profile URL or slug.
>
> **channel\_match** `string ("any" | "all")`
>
> Whether any or all requested channels must be available.
>
> **company\_domain** `string`
>
> Company domain to search.
>
> **people\_filters** `object`
>
> People-level filters. Different keys are ANDed; array values are alternatives.
>
> **required\_email** `boolean`
>
> Require known email availability; raw email is never unlocked.
>
> **company\_filters** `object`
>
> Documented Company Search filters defining the company set.
>
> **include\_company** `boolean`
>
> Include base company data with each person.
>
> **required\_mobile** `boolean`
>
> Require known mobile availability; raw numbers are never unlocked.
>
> **include\_domain\_intel** `boolean`
>
> Include base domain intelligence with each person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People V3 Singular Docs Alias
>
> **Slug:** `LEADMAGIC_SEARCH_PEOPLE_V3_SINGULAR_DOCS_ALIAS`
>
> Search 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
>
> **limit** `integer`
>
> People to return on this cursor page (1-10), charged per returned person.
>
> **query** `string`
>
> Free-text people or title query.
>
> **roles** `array`
>
> Role or function labels to match.
>
> **title** `string`
>
> Single job title to match.
>
> **cursor** `string`
>
> Opaque next\_cursor from the prior page. Pass it unchanged; filters are retained.
>
> **titles** `array`
>
> Job titles to match as alternatives.
>
> **channels** `array`
>
> Legacy contact-availability requirements.
>
> **job\_title** `string`
>
> Legacy single job-title filter.
>
> **company\_name** `string`
>
> Company name to search.
>
> **linkedin\_url** `string`
>
> Professional company profile URL or slug.
>
> **channel\_match** `string ("any" | "all")`
>
> Whether any or all requested channels must be available.
>
> **company\_domain** `string`
>
> Company domain to search.
>
> **people\_filters** `object`
>
> People-level filters. Different keys are combined with AND; array values are alternatives.
>
> **required\_email** `boolean`
>
> Only return people with known email availability; raw email is never unlocked.
>
> **company\_filters** `object`
>
> Documented Company Search filters defining the company set.
>
> **include\_company** `boolean`
>
> Include base company data with each person.
>
> **required\_mobile** `boolean`
>
> Only return people with known mobile availability; raw numbers are never unlocked.
>
> **include\_domain\_intel** `boolean`
>
> Include base domain intelligence with each person.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit Bulk Job
>
> **Slug:** `LEADMAGIC_SUBMIT_BULK_JOB`
>
> Create 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
>
> **csv** `string`
>
> Inline CSV data. Mutually exclusive with rows, file\_url, and scrape.
>
> **rows** `array`
>
> Inline JSON row objects. Mutually exclusive with csv, file\_url, and scrape.
>
> **format** `string ("csv" | "json" | "jsonl")`
>
> Remote file format; valid only with file\_url.
>
> **scrape** `object`
>
> Browser-rendering input. Mutually exclusive with rows, csv, and file\_url.
>
> **product** `string` *required*
>
> Enrichment product applied to every submitted row.
>
> **callback** `object`
>
> Optional webhook delivery configuration.
>
> **file\_url** `string`
>
> Public HTTPS CSV, JSON, or JSONL URL. Mutually exclusive with rows, csv, and scrape.
>
> **metadata** `object`
>
> Caller metadata attached to the bulk job.
>
> **priority** `integer`
>
> Queue priority from -1000 to 1000.
>
> **file\_name** `string`
>
> Label shown for the job in the LeadMagic dashboard.
>
> **preset\_id** `string`
>
> Saved bulk preset identifier.
>
> **input\_mapping** `object`
>
> Map source columns or fixed values to product input fields.
>
> **idempotency\_key** `string`
>
> Stable key that makes retries resolve to the same submission.
>
> **output\_transform** `object`
>
> Optional transformation applied to completed row output.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit Bulk Local Leads Job
>
> **Slug:** `LEADMAGIC_SUBMIT_BULK_LOCAL_LEADS_JOB`
>
> Create 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
>
> **cities** `array` *required*
>
> Cities expanded against every keyword.
>
> **keywords** `array` *required*
>
> Search terms expanded against every city, one row per keyword-city pair.
>
> **file\_name** `string`
>
> Label shown for the job in the LeadMagic dashboard.
>
> **magic\_key** `string`
>
> Promotional key that waives charges only when LeadMagic accepts it.
>
> **country\_codes** `array`
>
> Two-letter country code per city, aligned by index; omitted entries default to US.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit Mixed Product Batch
>
> **Slug:** `LEADMAGIC_SUBMIT_MIXED_PRODUCT_BATCH`
>
> Create an asynchronous mixed-product enrichment batch of up to 500 items. Managed access is not available; batch lookups may consume credits.
>
> #### Input Parameters
>
> **items** `array` *required*
>
> One to 500 mixed-product batch items. Every item explicitly names its product and input.
>
> **metadata** `object`
>
> Arbitrary metadata stored with the whole batch.
>
> **priority** `string ("normal" | "low")`
>
> Queue priority for the batch.
>
> **client\_id** `string`
>
> Client identifier associated with the whole batch.
>
> **client\_name** `string`
>
> Client name recorded with the whole batch.
>
> **webhook\_url** `string`
>
> Public HTTPS URL to notify when the batch completes.
>
> **budget\_user\_id** `string`
>
> Member whose credit budget should be charged.
>
> **idempotency\_key** `string`
>
> Deduplication key. Reusing it returns the original batch instead of creating another.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Batch Metadata
>
> **Slug:** `LEADMAGIC_UPDATE_BATCH_METADATA`
>
> Update 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
>
> **product** `string` *required*
>
> Enrichment product slug for the batch. Hyphens and underscores are accepted.
>
> **batch\_id** `string` *required*
>
> Identifier of the owned batch to update.
>
> **metadata** `object`
>
> Replacement provider-defined metadata for the batch.
>
> **client\_id** `string`
>
> Client identifier to associate with the batch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Bulk Job Priority
>
> **Slug:** `LEADMAGIC_UPDATE_BULK_JOB_PRIORITY`
>
> Change the priority of a queued or running LeadMagic bulk job owned by the connected workspace. This action is unavailable with managed credentials.
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> UUID of a queued or running bulk job created and owned by the connected workspace. Never reprioritize a pre-existing unrelated job.
>
> **priority** `integer` *required*
>
> New queue priority from -1000 (lowest) to 1000 (highest).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Credit Budget
>
> **Slug:** `LEADMAGIC_UPDATE_CREDIT_BUDGET`
>
> Update 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
>
> **id** `string` *required*
>
> Identifier of the owned budget to update.
>
> **period** `string`
>
> Replacement budget reset period.
>
> **alert\_email** `string`
>
> Replacement email address for budget threshold alerts.
>
> **max\_credits** `number`
>
> Replacement credit limit for each budget period.
>
> **alert\_threshold\_pct** `number`
>
> Replacement alert threshold as a fraction from 0 to 1.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Validate Bulk Submission
>
> **Slug:** `LEADMAGIC_VALIDATE_BULK_SUBMISSION`
>
> Validate 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
>
> **csv** `string`
>
> Inline CSV; exclusive with rows, file\_url, and scrape.
>
> **rows** `array`
>
> Inline JSON rows; exclusive with csv, file\_url, and scrape.
>
> **format** `string ("csv" | "json" | "jsonl")`
>
> Format for file\_url only.
>
> **scrape** `object`
>
> Browser input; exclusive with rows, csv, and file\_url.
>
> **product** `string` *required*
>
> Enrichment product to validate.
>
> **callback** `object`
>
> Callback configuration.
>
> **file\_url** `string`
>
> Public HTTPS input URL; exclusive with rows, csv, and scrape.
>
> **metadata** `object`
>
> Job metadata.
>
> **priority** `integer`
>
> Queue priority from -1000 to 1000.
>
> **file\_name** `string`
>
> Dashboard job label.
>
> **preset\_id** `string`
>
> Saved bulk preset identifier.
>
> **input\_mapping** `object`
>
> Source-to-product field mapping.
>
> **idempotency\_key** `string`
>
> Submission idempotency key.
>
> **output\_transform** `object`
>
> Completed-row output transformation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Validate Email
>
> **Slug:** `LEADMAGIC_VALIDATE_EMAIL`
>
> Check 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
>
> **email** `string` *required*
>
> The single email address to validate.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
