LeadMagic for AI agents
Agents read LeadMagic at once. Changes and sends are held for a person's approval by default.
About LeadMagic
LeadMagic provides people, company, jobs, advertising, and enrichment data for sales and recruiting workflows.
What an agent can do in LeadMagic
Every LeadMagic action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in LeadMagic without asking first. 90 actions.
- Detect Job ChangeCheck whether a person has changed jobs relative to an expected company. A resolved check costs 3 credits; PROFILE_NOT_FOUND costs 0 credits.
- Download Bulk Job Results CSVDownload all result rows for an owned bulk job as a CSV file. Use only a jobId captured from the same submission chain. The streamed download is offloaded and fails if it exceeds the documented 50 MiB
- Enrich Company V1Call POST /v1/companies/company-search to enrich one company from its domain, name, or business profile identifier. A successful enriched-company result costs 1 credit; use credits_consumed as the fin
- Enrich Company V3 Docs AliasCall the distinct documented POST /v3/companies/enrich alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsing
- Find Company Competitors V1Find competitors from a company domain, profile, or name. A successful competitor list costs 5 credits.
- Find Company Employees V1Find up to 10 employees at one company, returning names, titles, locations, and professional profile URLs. Provider documentation conflicts between 0.05 and 1 credit per returned employee, so treat 1
- Find Jobs V1Call POST /v1/jobs/jobs-finder to find jobs with the LeadMagic V1 filters. Each returned job costs 1 credit; an empty result costs 0 credits. per_page is capped at 50.
- Find Lookalike Companies V3Find similar companies from a seed domain, name, or description. The OpenAPI contract documents a flat 5-credit charge for a non-empty result and no charge when empty; another provider surface says 1
- Find Mobile PhoneFind one person's mobile phone number from a professional profile URL or known email. A found mobile number costs 5 credits; no result is free. Exactly one person is processed per call.
- Find Personal EmailFind one person's personal email addresses from a professional profile URL or identifier. A successful result costs 2 credits. Personal email addresses are sensitive personal data; use this tool only
- Find Person By Role V1Find one person by job title at a specified company. A successful match costs 2 credits; rely on credits_consumed as finalized spend. The response can contain personal identity and professional profil
- Find Work EmailFind one person's work email from their name and company domain or name. A found valid email costs 1 credit; no result is free. Exactly one person is processed per call.
Show all 90
- Find Work Email From B2B ProfileFind one person's work email from a professional profile URL or slug. LeadMagic's published sources conflict on whether a successful result costs 1 or 5 credits; treat 5 credits as the maximum documen
- Get Account OverviewReturn the connected workspace's available credits, API-key permission summary, current rate limits, and today's usage. This read is free.
- Get Analytics All Time SummaryGet documented lifetime account request, credit, product, success, and latency statistics, optionally restricted to a date range. This free analytics route was not individually live-probed during the
- Get Analytics Credit HistoryGet LeadMagic credit consumption history with a daily breakdown.
- Get Analytics Daily MetricsGet documented daily request, credit, latency, and error metrics for the last 1 to 90 days. This free analytics route was not individually live-probed during the build.
- Get Analytics Day BreakdownGet the documented per-product request and credit breakdown for one date. This free analytics route was not individually live-probed during the build.
- Get Analytics ProductsGet per-product LeadMagic usage with request, credit, and success metrics.
- Get Analytics UsageGet daily LeadMagic usage with request, credit, and chargeable-rate totals.
- Get B2B Ad Details V1Get full details for a specific B2B ad from its library URL, detail path, or numeric ID. A successful full-details lookup costs exactly 2 credits; use credits_consumed as finalized spend.
- Get B2B Profile From EmailFind one person's professional profile from a supplied work or personal email. A found complete profile costs 10 credits. Email addresses and matched profile data are personal data; submit and use the
- Get B2B Profile From Profile URLRetrieve one person's professional profile, including employment, education, certifications, and honors, from a profile URL or slug. A found full profile costs 1 credit. Returned profile data is perso
- Get BatchRead status, progress, cost, and metadata for a mixed-product batch by its exact batch identifier. A missing synthetic identifier safely returns not found and does not mutate or spend credits.
- Get Batch Campaign MetricsRead aggregate usage and success metrics for a batch campaign. A syntactically valid missing identifier can be used for a safe, non-mutating not-found check.
- Get Batch Client MetricsRead aggregate batch usage and success metrics for one client UUID. An all-zero missing UUID is safe for a non-mutating not-found check.
- Get Bulk CapabilitiesReturn the current bulk submission limits and supported operational features in a stable agent-facing shape. Service-internal host and deployment metadata are intentionally omitted.
- Get Bulk JobRead status, progress, timestamps, and finalized credit usage for one bulk job. Pass a jobId captured from the same owned submission workflow; do not inspect an unrelated workspace job.
- Get Bulk Job ProgressReturn LeadMagic's compact progress snapshot for frequent polling of one bulk job owned by the connected workspace. This read does not start, stop, or restart processing.
- Get Company Funding V1Call POST /v1/companies/company-funding to get complete funding history and related company intelligence by domain or name. A successful funding result costs 4 credits.
- Get Company Funding V3 Company Docs AliasCall the distinct documented POST /v3/companies/company-funding alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when
- Get Company Funding V3 Docs AliasCall the distinct documented POST /v3/companies/funding alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsin
- Get Company Technographics V1Get a company's technology stack from its domain. A successful stack result costs 1 credit; use credits_consumed as finalized spend.
- Get Credit Balance V1Check the connected LeadMagic workspace's current credit balance for free.
- Get Credit Budget StatusRead current limits, remaining credits, and exceeded state for every LeadMagic credit budget. This does not reserve or consume credits.
- Get Credit Service Health V1 Docs OnlyValidate the connected LeadMagic API key and check credit-service authentication status. This medium-confidence docs-only read has an undocumented response schema and billing behavior and was not live
- Get Email Suppression ListReturn one offset-controlled page of details and irreversible SHA-256 email hashes for one owned suppression list. Use only the exact list_id captured in the same create lifecycle, never auto-fetch pa
- Get Job Board Stats V3Return the free job search dataset statistics through LeadMagic's exact job-board integration alias route.
- Get Job Search CatalogsReturn the free filter catalogs used by job search, including countries, regions, job types, industries, company types, and seniority values. This helper consumes 0 credits.
- Get Job Search Dataset Stats V3Return free public coverage, freshness, and capability statistics for the LeadMagic Jobs Search index.
- Get Search StatsReturn free cached coverage, capabilities, and top dimensions for selected LeadMagic search products. Requested product sections may be absent when unavailable. This helper costs 0 credits.
- List Batch ClientsList existing organization-scoped client records used to segment batch work. This read does not create or modify clients.
- List Batch Client WebhooksList delivery webhooks configured for one batch client. This read does not create, change, or invoke webhooks.
- List BatchesList one bounded page of mixed-product batches for the connected organization. Continue only with the returned next_offset; this tool never auto-fetches additional pages.
- List Bulk Job ErrorsReturn one offset-controlled page of failed rows and error details for a bulk job owned by the connected workspace. This is read-only and never retries or restarts failed rows.
- List Bulk Job EventsReturn the append-only event log, newest first, for one bulk job owned by the connected workspace. Reading events does not alter the job lifecycle.
- List Bulk Job ResultsReturn one bounded offset page of row-level JSON results for an owned bulk job. Use only a jobId captured from the same submission chain and pass next_offset back explicitly to continue; this tool nev
- List Bulk JobsReturn one bounded offset page of bulk jobs owned by the connected account, newest first. Use next_offset to continue; this action never auto-fetches pages.
- List Credit BudgetsList all persistent credit budgets configured for the connected LeadMagic workspace, including identifiers needed for owned-budget lifecycle operations.
- List Email Suppression ListsRead all suppression-list summaries for the connected workspace. This tool is for discovery only: never pass an ID from this result to a mutation or deletion; lifecycle writes must use the exact ID ca
- List External Batch ProvidersList organization-level external enrichment provider configurations. LeadMagic redacts stored credentials from this read.
- List Job Company Types V1List the company type IDs accepted by the legacy V1 Jobs Finder API. No route-specific charge is documented; reported finalized spend should be treated as authoritative.
- List Job Countries V1List the free country codes accepted by the legacy V1 Jobs Finder API. Use V3 catalogs or locations for V3 job search.
- List Job Industries V1List the industry IDs accepted by the legacy V1 Jobs Finder API. No route-specific charge is documented; reported finalized spend should be treated as authoritative.
- List Job Occupation Taxonomy V3Autocomplete LeadMagic's broad-to-specific occupation taxonomy and return canonical IDs, labels, levels, and paths. This helper is free and consumes 0 credits.
- List Job Regions V1List the free region IDs accepted by the legacy V1 Jobs Finder API. Use the exact returned IDs with V1 job searches.
- List Job Search Company Suggestions V3Autocomplete companies or resolve an exact domain into canonical company IDs and card data for Job Search filters. This helper is free and consumes 0 credits.
- List Job Search Location Suggestions V3Autocomplete countries, regions, states, and cities into canonical IDs for exact Job Search geo filters. This helper is free and consumes 0 credits.
- List Job Search Role Suggestions V3Autocomplete role names into canonical occupation taxonomy IDs for Job Search filters. This helper is free and consumes 0 credits.
- List Job Search Tag Suggestions V3Autocomplete normalized job tags with tag-type and occupation taxonomy metadata for Job Search filters. This helper is free and consumes 0 credits.
- List Job Search Title Suggestions V3Autocomplete searchable job title phrases with occupation taxonomy metadata for Job Search filters. This helper is free and consumes 0 credits.
- List Job Types V1List the job type IDs accepted by the legacy V1 Jobs Finder API. No route-specific charge is documented; reported finalized spend should be treated as authoritative.
- Lookup Company Domain V3 Docs AliasCall the distinct documented POST /v3/companies/domain-lookup alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when b
- Lookup Company V3 Docs AliasCall the distinct documented POST /v3/companies/lookup alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsing
- Preview Mixed Batch CostEstimate the maximum credit cost and budget impact of an exact mixed-product batch payload. This is a free dry run: it does not submit work, reserve credits, or consume credits.
- Search B2B Ads V1Search for B2B ads by company domain or name. The exact charge is 1 base credit plus 1 credit per returned ad, with a minimum of 1 credit. Set limit to bound the per-ad portion; use credits_consumed a
- Search CompaniesCall the canonical POST /v3/companies/search route to search or look up companies by domain, name, website, professional profile URL, or company filters and return one cursor-controlled page. On the c
- Search Companies V1 Legacy Docs AliasCall the distinct legacy compatibility route POST /v1/companies/search. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. Billing is 1 credit per search on metered plan
- Search Companies V3 Company Hyphenated Docs AliasCall the distinct documented POST /v3/companies/company-search alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. Billing is 1 credit per search on metered plans
- Search Google Ads V1Search for Google ads run by a company. Each returned ad costs exactly 1 credit and no results are free. The limit defaults to 1 to bound spend; use credits_consumed as finalized spend.
- Search JobsCall the canonical POST /v3/jobs/search route to search by title, company, location, taxonomy, tags, salary, seniority, date, and work arrangement, returning one cursor-controlled page. On the connect
- Search Jobs V1 Legacy Docs AliasCall the distinct legacy compatibility route POST /v1/jobs/search; prefer POST /v3/jobs/search for new integrations. Returns one cursor page. Billing is 1 credit per search on metered plans and unmete
- Search Jobs V2 Legacy Docs AliasCall the distinct legacy compatibility route POST /v2/jobs/search; prefer POST /v3/jobs/search for new integrations. Returns one cursor page. Billing is 1 credit per search on metered plans and unmete
- Search Jobs V3 Hyphenated OpenAPI AliasSearch the distinct documented POST /v3/jobs-search alias and return one cursor-controlled page. On metered plans, each returned job can cost 1 credit; the page limit is capped at 5 credits of result
- Search Jobs V3 Singular Docs AliasCall the distinct documented compatibility route POST /v3/job-search; prefer POST /v3/jobs/search for new integrations. Returns one cursor page. Billing is 1 credit per search on metered plans and unm
- Search Meta Ads V1Search for Meta ads by company domain or name. Each returned ad costs exactly 1 credit and no results are free. The limit defaults to 1 to bound spend; use credits_consumed as finalized spend.
- Search PeopleCall the canonical POST /v3/people/search route to search by company, title, role, free text, and contact availability, returning one cursor-controlled page without raw email or mobile details. On the
- Search People V1 Legacy Docs AliasCall the distinct legacy compatibility route POST /v1/people/search; prefer the canonical V3 route for new integrations. Returns one base-only cursor page and never requests raw contact details. Each
- Search People V2 Legacy Docs AliasCall the distinct legacy compatibility route POST /v2/people/search; prefer the canonical V3 route for new integrations. Returns one base-only cursor page and never requests raw contact details. Each
- Search People V3 By Title Docs AliasCall the distinct compatibility route POST /v3/people/by-title; prefer the canonical route for new integrations. Returns one base-only cursor page and never requests raw contact details. Each returned
- Search People V3 Company Docs AliasCall the distinct documented POST /v3/people/company-search alias. Prefer SEARCH_PEOPLE for new integrations. Returns one cursor page without raw contacts. Each returned person costs 1 base credit; ze
- Search People V3 Contacts By Title Docs AliasCall the distinct compatibility route POST /v3/people/contacts-by-title; prefer the canonical route for new integrations. Returns one base-only cursor page and never requests raw contact details. Each
- Search People V3 Employees Docs AliasCall the distinct compatibility route POST /v3/people/employees; prefer the canonical route for new integrations. Returns one base-only cursor page and never requests raw contact details. Each returne
- Search People V3 Full Docs AliasCall the distinct documented POST /v3/people/full-search alias. Prefer SEARCH_PEOPLE for new integrations. Despite its route name, raw contacts stay disabled. Each returned base person costs 1 credit;
- Search People V3 Icp Docs AliasCall the distinct documented compatibility route POST /v3/people/icp-search; prefer POST /v3/people/search for new integrations. Returns one base-only cursor page and never requests raw contact detail
- Search People V3 Lookalike Docs AliasCall the distinct compatibility route POST /v3/people/lookalike; prefer the canonical route for new integrations. Returns one base-only cursor page and never requests raw contact details. Each returne
- Search People V3 Mixed Docs AliasCall the distinct documented POST /v3/people/mixed-search alias. Prefer SEARCH_PEOPLE for new integrations. Returns one cursor page without raw contacts. Each returned person costs 1 base credit; zero
- Search People V3 Singular Docs AliasCall the distinct documented POST /v3/person/search alias. Prefer SEARCH_PEOPLE for new integrations. Returns one cursor page of base person data without raw contacts. Each returned person costs 1 bas
- Validate Bulk SubmissionValidate exactly one bulk input mode and its options without persisting or processing a job. This is a contract check, not a submission.
- Validate EmailCheck one email address for deliverability and return mail-server and company context. A definitive valid or invalid result costs 0.25 credits; an unknown result is free. Exactly one email is validate
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 19 actions.
- Add Emails To Suppression ListAdd a non-empty plaintext email list to one owned suppression list; LeadMagic stores only normalized SHA-256 hashes. Use the exact list_id captured in the same create lifecycle and only addresses inte
- Create Credit BudgetCreate a persistent credit budget that caps spend for one LeadMagic scope. Record the returned id so the owned budget can be updated or deleted later.
- Create Email Suppression ListCreate an owned suppression list from a unique list_id and non-empty plaintext email list. LeadMagic hashes emails server-side. Capture the returned list_id, use only that exact ID for subsequent read
- Create Job Search Export V3Synchronously export up to 5,000 matching jobs. At least one search filter is required. This route is credit-metered, but LeadMagic does not publish an exact rate. The limit defaults to 1 and bounds r
- Delete Credit BudgetPermanently delete one credit budget. This is an irreversible teardown action: use only the exact budget ID captured from Create Credit Budget in the same owned lifecycle, and never delete a budget di
- Delete Email Suppression ListPermanently delete an entire suppression list and its stored hashes. This is an irreversible teardown action: use only the exact list_id captured from Create Email Suppression List in the same owned l
- Pause Bulk JobPause a queued or running LeadMagic bulk job. This mutates processing state but is reversible with Resume Bulk Job. Use only a job ID owned by the connected workspace and intentionally selected for th
- Refresh Credit Cache V1 Docs OnlyForce LeadMagic to refresh the connected workspace's credit cache from its database. This medium-confidence docs-only POST updates cached account state; its response schema and billing behavior are un
- Remove Emails From Suppression ListIrreversibly remove specific email suppressions from one owned list, allowing those addresses to be processed again. Use only the exact list_id captured in the same create lifecycle and the exact life
- Resolve Job Search Filters V3Resolve friendly job-search companies, tags, occupation taxonomy, locations, and titles into canonical values. This helper returns no jobs and costs 0 credits.
- Restart Bulk JobDestructively restart a LeadMagic bulk job in full, for failed rows only, or from a zero-based row or shard. This irreversible lifecycle operation can repeat work and consume additional credits. Use o
- Resume Bulk JobResume a paused LeadMagic bulk job. This mutates processing state and may continue the job's existing credit-consuming work. Use only a job ID owned by the connected workspace and intentionally paused
Show all 19
- Review Bulk JobResume or irreversibly cancel an owned bulk job. Use only a jobId captured from the same submission chain, choose a state-valid transition, and never mutate a pre-existing job discovered by listing wo
- Submit Bulk JobCreate one asynchronous bulk enrichment job from exactly one input mode. This can consume credits for every processed row. Retain the returned jobId and use only that owned ID for follow-up reads or l
- Submit Bulk Local Leads JobCreate a long-running local-leads bulk job. Every keyword-city combination becomes work and may consume credits. Retain the returned jobId and use only that owned ID for follow-up reads or lifecycle c
- Submit Mixed Product BatchCreate one asynchronous mixed-product enrichment batch. This can consume credits for every item: preview the exact payload first, keep the item count bounded, and supply an idempotency_key before subm
- Update Batch MetadataUpdate metadata or client association for an owned batch during its mutable window. Use only a product and batch_id captured from the same submitted batch; never mutate a batch discovered by listing w
- Update Bulk Job PriorityChange the priority of a queued or running LeadMagic bulk job owned by the connected workspace. This mutates scheduling but does not restart the job or change which rows it processes.
- Update Credit BudgetUpdate one or more controls on a credit budget created and owned by the caller. Use only an id captured from that owned budget lifecycle; never modify a budget discovered incidentally in workspace lis
Changes wait in Needs you
Changes and sends in LeadMagic are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
LeadMagic questions
Can an agent change data in LeadMagic on its own?
Not by default. Changes and sends in LeadMagic are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in LeadMagic?
This connector lists 90 read actions. Reads run at once, without waiting for approval.
How does LeadMagic connect?
It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.