Leadfeeder integration
Leadfeeder (by Dealfront) identifies the companies visiting your website and enriches B2B company and contact data. Search and read web visits and visiting companies, manage custom feeds and goals, search, match and enrich companies and contacts, enrich an IP address to a company, organise records with lists, tags and custom fields, define buyer personas and ideal customer profiles, and read campaigns and API usage. Account settings routes (cookie consent, data processing) are not exposed. Authentication is a personal API key sent in the X-Api-Key header; most routes also take the account_id of the Leadfeeder account to act on, as returned by list_accounts.
Say what should happen.
The workflow builds itself.
What you can do with Leadfeeder
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
List, 9 operations
add_company_to_listsAdd company to listsPOSTAllows the addition of this company to one or more lists.add_contact_to_listsAdd contact to listsPOSTAllows the addition of this contact to one or more lists.create_listCreate listPOSTCreate a new list in the account. :::info Requires the `lists:write` OAuth2 scope. :::delete_listDelete listDELETEDelete a list from the account. Once removed, the list will no longer be accessible. Credit Note: Deleting list does not consume credits.get_listGet listGETRetrieve the details of a specific list using its unique ID.list_listsList listsGETRetrieve all lists available in the account. The response includes each list's attributes and can be filtered through query parameters.remove_company_from_listsRemove company from listsDELETEAllows the removal of this company from one or more lists. Credit Note: Removing a company from lists does not consume credits. :::info Requires the `companies:write` OAuth2 scope.remove_contact_from_listsRemove contact from listsDELETEAllows the removal of this contact from one or more lists. Credit Note: Removing a contact from lists does not consume credits. :::info Requires the `contacts:write` OAuth2 scope.update_listUpdate listPATCHUpdate the name of a list. Credit Note: Updating list name does not consume credits. :::info Requires the `lists:write` OAuth2 scope. :::
Tag, 7 operations
assign_tags_to_companyAssign tags to companyPOSTAllows the assignment of one or more tags to a given company.create_tagCreate tagPOSTCreate a new tag with the provided attributes. This endpoint allows clients to define a new tag that can be assigned to companies.delete_tagDelete tagDELETEDelete a specific tag identified by its ID Removes the tag from the account and unassigns it from all associated companies. Once deleted, the tag cannot be recovered.get_tagGet tagGETFetch the details of a specific tag using its unique tag ID.list_tagsList tagsGETRetrieve the list of all tags available in the account.unassign_tags_from_companyUnassign tags from companyDELETEAllows the unassignment of one or more tags from a given company. Credit Note: Unassigning tags from a company does not consume credits.update_tagUpdate tagPATCHUpdate the attributes of a specific tag identified by its ID. This endpoint applies a partial update to a single tag.
Company, 6 operations
get_companies_by_idsGet companies by idsGETFetch full company records for up to 100 company ids (comma-separated), as returned by search_companies or match_companies. Consumes 1 credit per record unless it was accessed in the last 12 months.get_companyGet companyGETFetch one company's full record (firmographics, hierarchy) by its Leadfeeder company id, as returned by search_companies. Consumes 1 credit per record unless it was accessed in the last 12 months.get_company_icp_matchesGet company icp matchesPOSTFind out which Ideal Customer Profiles each of your companies matches. Pass up to 100 company IDs in `ids` and get one entry per company, in the same order.get_company_list_membershipsGet company list membershipsPOSTFind out which lists each of your companies belongs to. Pass up to 100 company IDs in `ids` and get one entry per company, in the same order. Each entry names the lists by ID.list_visitor_companiesList visitor companiesGETRetrieve a paginated list of companies that visited your website within a given date range. Each item includes references to the company and its inferred geographic location.update_companyUpdate companyPATCHUpdate a company. Applies a partial (merge-patch) update to the company: only the attributes named in the request are changed; any attribute you omit is left untouched.
Buyer persona, 5 operations
create_buyer_personaCreate buyer personaPOSTCreate a new buyer persona in the account. Credit Note: Creating a buyer persona does not consume credits. :::info Requires the `buyer_personas:write` OAuth2 scope. :::delete_buyer_personaDelete buyer personaDELETEDelete a buyer persona by its ID. :::info Requires the `buyer_personas:write` OAuth2 scope. :::get_buyer_personaGet buyer personaGETGet the details of a specific buyer persona by ID, including its name, creation timestamp, and the full set of filter criteria that define it.list_buyer_personasList buyer personasGETRetrieve all buyer personas defined in the account.update_buyer_personaUpdate buyer personaPATCHUpdate an existing buyer persona. All attributes are optional; only the attributes you send are changed. Sending `filters` replaces every category, not just the one you name.
Custom feed, 5 operations
create_custom_feedCreate custom feedPOSTCreate a new custom feed for the given account. :::info Requires the `web_visits:write` OAuth2 scope. :::delete_custom_feedDelete custom feedDELETEDelete a custom feed by its ID. :::info Requires the `web_visits:write` OAuth2 scope. :::get_custom_feedGet custom feedGETRetrieve a single custom feed by its ID. :::info Requires the `web_visits:read` OAuth2 scope. :::list_custom_feedsList custom feedsGETRetrieve all custom feeds accessible to the current user for the given account. :::info Requires the `web_visits:read` OAuth2 scope. :::update_custom_feedUpdate custom feedPATCHUpdate an existing custom feed. All attributes are optional; only provided attributes will be updated. :::info Requires the `web_visits:write` OAuth2 scope. :::
Custom field, 5 operations
create_custom_fieldCreate custom fieldPOSTCreate a new custom field in the account. :::info Requires the `custom_fields:write` OAuth2 scope. :::delete_custom_fieldDelete custom fieldDELETEDelete a custom field from the account. Once removed, the custom field will no longer be accessible. Credit Note: Deleting custom fields does not consume credits.get_custom_fieldGet custom fieldGETFetch the details of a specific custom field using its internal name. The response returns the field's attributes.list_custom_fieldsList custom fieldsGETRetrieve the list of all custom field definitions available in the account. The response includes each field's attributes.update_custom_fieldUpdate custom fieldPATCHUpdate an existing custom field's name and/or configuration. At least one of `name` or `configuration` must be provided. If `name` is present, it must not be blank.
Goal, 5 operations
create_goalCreate goalPOSTCreate a goal in the account. A goal only marks page views tracked after it is created; earlier visits are not re-checked.delete_goalDelete goalDELETEDelete a goal by its ID. Its custom feed is deleted too, and the goal is removed from the page views it marked.get_goalGet goalGETGet a goal by its ID, including its name, whether it is enabled and the page-view condition that defines it. Credit Note: Retrieving a goal does not consume credits.list_goalsList goalsGETRetrieve all goals defined in the account.update_goalUpdate goalPATCHUpdate an existing goal. All attributes are optional; only the attributes you send are changed.
Icp, 5 operations
create_icpCreate icpPOSTCreate a new Ideal Customer Profile (ICP) in the account. Creating an ICP also creates the custom feed that surfaces the companies matching it.delete_icpDelete icpDELETEDelete an ICP by its ID. This also deletes the custom feed created alongside it. :::info Requires the `icps:write` OAuth2 scope. :::get_icpGet icpGETGet the details of a specific Ideal Customer Profile (ICP) by ID, including its name, creation timestamp, and the full set of filter criteria that define it.list_icpsList icpsGETRetrieve all Ideal Customer Profiles (ICPs) defined in the account.update_icpUpdate icpPATCHUpdate an existing Ideal Customer Profile (ICP). All attributes are optional; only the attributes you send are changed.
Contact, 4 operations
get_contactGet contactGETFetch one contact's full record by id, as returned by search_contacts. Consumes 1 credit per record unless it was accessed in the last 12 months.get_contact_list_membershipsGet contact list membershipsPOSTFind out which lists each of your contacts belongs to. Pass up to 100 contact IDs in `ids` and get one entry per contact, in the same order. Each entry names the lists by ID.get_contacts_by_idsGet contacts by idsGETFetch full contact records for up to 100 contact ids (comma-separated), as returned by search_contacts. Consumes 1 credit per record unless it was accessed in the last 12 months.update_contactUpdate contactPATCHUpdate a contact. Applies a partial (merge-patch) update to the contact: only the attributes named in the request are changed; any attribute you omit is left untouched.
Campaign, 3 operations
get_campaignGet campaignGETFetch detailed information about a specific campaign using its campaign ID.list_campaignsList campaignsGETRetrieve the list of all campaigns available in the account.update_campaignUpdate campaignPATCHUpdate a specific campaign using its campaign ID. Supports changes to campaign attributes such as name, budget, status, associated list or custom feed, and campaign settings.
Batch add tags job, 2 operations
create_batch_add_tags_jobCreate batch add tags jobPOSTSchedule an asynchronous job that adds the tags in `data.attributes.tags` to a set of companies. Every tag is added to every selected company.get_batch_add_tags_jobGet batch add tags jobGETRetrieve the status of a batch add-tags job created via `create_batch_add_tags_job`. While `status` is `running`, `summary` is omitted.
Batch add to list job, 2 operations
create_batch_add_to_list_jobCreate batch add to list jobPOSTSchedule an asynchronous job that adds members to a single list.get_batch_add_to_list_jobGet batch add to list jobGETRetrieve the status of a batch add-to-list job created via `create_batch_add_to_list_job`. While `status` is `running`, `results` and `summary` are omitted.
Batch remove from list job, 2 operations
create_batch_remove_from_list_jobCreate batch remove from list jobPOSTSchedule an asynchronous job that removes members from a single list.get_batch_remove_from_list_jobGet batch remove from list jobGETRetrieve the status of a batch remove-from-list job created via `create_batch_remove_from_list_job`. While `status` is `running`, `results` and `summary` are omitted.
Batch remove tags job, 2 operations
create_batch_remove_tags_jobCreate batch remove tags jobPOSTSchedule an asynchronous job that removes the tags in `data.attributes.tags` from a set of companies. Every tag is removed from every selected company.get_batch_remove_tags_jobGet batch remove tags jobGETRetrieve the status of a batch remove-tags job created via `create_batch_remove_tags_job`. While `status` is `running`, `summary` is omitted.
Enrichment job, 2 operations
create_company_enrichment_jobCreate company enrichment jobPOSTStart a background job that fills an AI custom field for companies; consumes credits (check estimate_company_enrichment_job first). Poll get_company_enrichment_job with the returned id.get_company_enrichment_jobGet company enrichment jobGETRetrieve the current status of a Company AI Enrichment job. Returns progress counters, credit consumption, and any errors. Jobs are retained for 7 days after completion.
Estimate, 2 operations
estimate_company_enrichment_jobEstimate company enrichment jobPOSTEstimate the credit cost for enriching companies with AI-generated custom field values.estimate_find_contact_data_jobEstimate find contact data jobPOSTEstimate the credit cost for enriching contacts with email and phone data. Accepts either explicit `contact_ids` or a `list_id` to target an entire list.
Find contact data job, 2 operations
create_find_contact_data_jobCreate find contact data jobPOSTStart a background job revealing email and phone data for contacts; consumes credits (check estimate_find_contact_data_job first). Poll get_find_contact_data_job with the returned id.get_find_contact_data_jobGet find contact data jobGETRetrieve the current status of a Find Contact Data job. Returns progress counters, credit consumption, and any errors. Jobs are retained for 7 days after completion.
Search, 2 operations
search_companiesSearch companiesPOSTPerform search queries using criteria like name, location, industry, size or filters like `has_phone`. Returns matching company IDs and basic company information.search_contactsSearch contactsPOSTSearch for contacts based on the provided search parameters and returns contact summary objects. Credit Note: Searches do not consume credits.
Account, 1 operation
list_accountsList accountsGETRetrieves a list of Leadfeeder accounts associated with this API key. Without `account_id`, all accounts are listed with their names only.
Country, 1 operation
list_countriesList countriesGETReturns the full list of countries with their administrative regions. Credit Note: This endpoint does not consume credits. :::info Requires the `companies:read` OAuth2 scope. :::
Custom feeds folder, 1 operation
list_custom_feed_foldersList custom feed foldersGETRetrieve all custom feed folders accessible to the current user for the given account. :::info Requires the `web_visits:read` OAuth2 scope. :::
Enrich, 1 operation
enrich_ipEnrich ipGETEnriches an input IP (IPv4/IPv6) with matching company information (if any). **Note:** - This endpoint requires an active subscription to the IP Enrich product.
Financial, 1 operation
get_company_financialsGet company financialsGETReturn all financial reports for one company. Consumes 1 credit when financial data exists and the company had no deep data access in the last 12 months.
Geo suggestion, 1 operation
list_geo_suggestionsList geo suggestionsGETResolves a typed city name or postal code into geographic coordinates.
Industry, 1 operation
list_industriesList industriesGETReturns the full list of industries based on the provided industry classification. Credit Note: This endpoint does not consume credits.
Ip, 1 operation
list_company_ipsList company ipsGETFetch known IP addresses of up to 100 companies. Consumes 1 credit per company unless its IP data was accessed in the last 12 months.
Item, 1 operation
list_list_itemsList list itemsGETRetrieve the members of a list. The list is addressed by its `{id}`, a scope-prefixed list identifier (e.g. `company_123` or `contact_456`).
Match, 1 operation
match_companiesMatch companiesPOSTFind matching companies based on the provided input parameters. Returns matching company IDs and basic company information.
Me, 1 operation
get_current_userGet current userGETRetrieves the identity of the current API user - a "whoami" endpoint.
Signal, 1 operation
search_company_signalsSearch company signalsPOSTRetrieve signals for a specified set of company IDs. The response returns the signals linked to the provided companies.
Stats, 1 operation
get_campaign_statsGet campaign statsGETRetrieve statistics for a specific campaign over a defined time period.
Tracker, 1 operation
get_tracker_scriptGet tracker scriptGETRetrieve the tracking script for the given account. The response includes the script hash and a ready-to-use HTML snippet to embed on your website to enable visitor tracking.
Usage, 1 operation
get_usageGet usageGETAccess usage statistics for various API endpoints for monitoring and auditing purposes.
Web visit, 1 operation
search_web_visitsSearch web visitsPOSTSearch for web visits within a date range. Returns a paginated list of visit records including engagement data, visitor information, and location.
Use Leadfeeder from Claude Code, Cursor or Codex
Connect Leadfeeder in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Leadfeeder operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Leadfeeder
- Create your workspace
Sign up free. Nothing to install.
- Connect Leadfeeder once
Add your Leadfeeder connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Leadfeeder integration FAQ
What can you do with the Leadfeeder integration?
LiveContext exposes 86 operations on Leadfeeder, covering list, tag, company and buyer persona.
