Skip to content
Changelog

Report a bug

Leadfeeder integration: operations for AI agents

Leadfeeder connects to Type.com as an integration. This page lists the 90 operations documented for Claude and Codex in Type.com: 49 read, 31 write, 10 destructive.

About Leadfeeder

Leadfeeder identifies companies visiting your website and converts them into high-value leads.

Categories: Analytics & Data

How to connect Leadfeeder to Type.com

Access
Organization connection: one shared account for the workspace.

To add the connection, follow the steps in Space connections.

Documented operations

90 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

90 operations listed.

Account

  • Read

    List Accounts

    Retrieves a list of Leadfeeder accounts associated with this API key. Without accountid, all accounts are listed with their names only. With accountid, only that account is returned, including its credit details. :::info Requires the accounts:read OAuth2 scope. :::

Buyer Personas

  • Read

    Retrieve Buyer Personas

    Retrieve all buyer personas defined in the account. Each buyer persona is a saved set of contact-level filter criteria (department, job title, location, seniority) used to identify target contacts. Credit Note: Retrieving buyer persona definitions does not consume credits.

  • Read

    Get Buyer Persona Details

    Get the details of a specific buyer persona by ID, including its name, creation timestamp, and the full set of filter criteria that define it. Credit Note: Retrieving a buyer persona definition does not consume credits. :::info Requires the buyerpersonas:read OAuth2 scope. :::

  • Write

    Create a Buyer Persona

    Create a new buyer persona in the account. Credit Note: Creating a buyer persona does not consume credits. :::info Requires the buyerpersonas:write OAuth2 scope. :::

  • Write

    Update a Buyer Persona

    Update 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. :::info Requires the buyerpersonas:write OAuth2 scope. :::

  • Destructive

    Delete a Buyer Persona

    Delete a buyer persona by its ID. :::info Requires the buyerpersonas:write OAuth2 scope. :::

Campaigns

  • Read

    Retrieve Campaigns

    Retrieve the list of all campaigns available in the account. Use pagination to control the number of campaigns returned, and include related campaign data, campaign settings, list, or custom feed information when needed. :::info Requires the campaigns:read OAuth2 scope. :::

  • Read

    Get Campaign Details

    Fetch detailed information about a specific campaign using its campaign ID. Use the include parameter to attach related campaign data, campaign settings, list, or custom feed information to the result. :::info Requires the campaigns:read OAuth2 scope. :::

  • Read

    Retrieve Campaign Stats

    Retrieve statistics for a specific campaign over a defined time period. Use frequency, startperiod, and endperiod to control how the campaign performance data is grouped and returned. :::info Requires the campaigns:read OAuth2 scope. :::

  • Write

    Update Campaign

    Update 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. :::info Requires the campaigns:write OAuth2 scope. :::

Companies

  • Read

    Retrieve Companies

    Retrieve the list of companies based on provided IDs. Credit Note: Each company will contain it's full deep data and it will consumes 1 credit, unless the company was already accessed within the last 12 months. :::info Requires the companies:read OAuth2 scope. :::

  • Read

    Get Company Enrichment Job Status

    Retrieve 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. Credit Note: This endpoint does not consume credits. :::info Requires the companies:read OAuth2 scope. :::

  • Read

    Retrieve Company IPs

    Fetch known IP addresses associated with a given set of companies, enabling identification of web traffic and network activity linked to those organizations based on the provided company IDs.

  • Read

    Search Companies

    Perform search queries using criteria like name, location, industry, size or filters like hasphone. Returns matching company IDs and basic company information.

  • Read

    Search Company Signals

    Retrieve signals for a specified set of company IDs. The response returns the signals linked to the provided companies. Credit Node: You are charged 1 credit per company if the company has signals and there was no active deep data access within the last 12 months.

  • Read

    Get Company Details

    Fetch detailed information about a specific company, including firmographics and hierarchy information based on the provided Leadfeeder companyid. Credit Note: Accessing full deep data consumes 1 credit, unless the company was already accessed within the last 12 months.

  • Read

    Company Financial Reports

    Returns all financial reports for a given company. Credit Note: Accessing financial data consumes 1 credit per company only if financial data is available and there was no active deep data access within the last 12 months.

  • Write

    Create Company Enrichment Job

    Trigger an asynchronous job to enrich companies with AI-generated custom field values. The custom field must exist and be an AI field type (aiscore, aitext, ainumber, aiboolean) or a contactcollection field. Create custom fields via the Custom Fields API first.

  • Write

    Estimate Company Enrichment Job

    Estimate the credit cost for enriching companies with AI-generated custom field values. Target the estimate with a specific listid, flat companyids, or a pre-computed companycount. Credit Note: This endpoint does not consume credits.

  • Write

    Match Companies

    Find matching companies based on the provided input parameters. Returns matching company IDs and basic company information. Important: Each company object must include at least one of these required fields: companyname, url, vatid, or registerid.

  • Write

    Update a Company

    Update 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. This endpoint updates the company's custom field values.

  • Write

    Add Company to Lists

    Allows the addition of this company to one or more lists. Since lists are a separate entity, the IDs that you must pass in this endpoint come from the Retrieve Lists and Get List Details endpoints. Credit Note: Adding a company to lists does not consume credits.

  • Write

    Assign Tags to Company

    Allows the assignment of one or more tags to a given company. Since tags are a separate entity, the IDs that you must pass in this endpoint come from the Retrieve Tags and Get Tag Details endpoints. Credit Note: Assigning tags to a company does not consume credits.

  • Destructive

    Remove Company from Lists

    Allows 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. :::

  • Destructive

    Unassign Tags from Company

    Allows the unassignment of one or more tags from a given company. Credit Note: Unassigning tags from a company does not consume credits. :::info Requires the companies:write OAuth2 scope. :::

Contacts

  • Read

    Retrieve Contacts

    Retrieve a list of contacts based on the provided IDs. Credit Note: Each contact will contain its full deep data and it will consume 1 credit, unless the contact has already been accessed within the last 12 months. :::info Requires the contacts:read OAuth2 scope. :::

  • Read

    Get Find Contact Data Job Status

    Retrieve 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. Credit Note: This endpoint does not consume credits. :::info Requires the contacts:read OAuth2 scope. :::

  • Read

    Search Contacts

    Search for contacts based on the provided search parameters and returns contact summary objects. Credit Note: Searches do not consume credits. Credits are only used if you subsequently retrieve deep data for a contact that has not been accessed within the last 12 months.

  • Read

    Get Contact Details

    Get the details of a contact by ID. Credit Note: Accessing full deep data consumes 1 credit, unless the contact was already accessed within the last 12 months. :::info Requires the contacts:read OAuth2 scope. :::

  • Write

    Create Find Contact Data Job

    Trigger an asynchronous job to enrich the given contacts with email and phone data. Accepts either explicit contactids or a listid to target an entire list. The job runs in the background; poll the status endpoint to check progress.

  • Write

    Estimate Find Contact Data Job

    Estimate the credit cost for enriching contacts with email and phone data. Accepts either explicit contactids or a listid to target an entire list. Returns the number of eligible contacts and the estimated total credits that would be consumed.

  • Write

    Update a Contact

    Update 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. This endpoint updates the contact's custom field values.

  • Write

    Add Contact to Lists

    Allows the addition of this contact to one or more lists. Since lists are a separate entity, the IDs that you must pass in this endpoint come from the Retrieve Lists and Get List Details endpoints. Credit Note: Adding a contact to lists does not consume credits.

  • Destructive

    Remove Contact from Lists

    Allows 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. :::

Reference Data

  • Read

    Get Countries with Regions

    Returns the full list of countries with their administrative regions. Credit Note: This endpoint does not consume credits. :::info Requires the companies:read OAuth2 scope. :::

  • Read

    Get Geo Suggestions

    Resolves a typed city name or postal code into geographic coordinates. The returned latitude / longitude can be used to populate the value.lat / value.lon of the Geo Filter (field: geo, operator: within).

  • Read

    Get Industries

    Returns the full list of industries based on the provided industry classification. Credit Note: This endpoint does not consume credits. :::info Requires the companies:read OAuth2 scope. :::

Custom Fields

  • Read

    Retrieve Custom Fields

    Retrieve the list of all custom field definitions available in the account. The response includes each field's attributes. Credit Note: Retrieving custom field definitions does not consume credits. :::info Requires the customfields:read OAuth2 scope. :::

  • Read

    Get Custom Field Details

    Fetch the details of a specific custom field using its internal name. The response returns the field's attributes. Credit Note: Retrieving custom field definitions does not consume credits. :::info Requires the customfields:read OAuth2 scope. :::

  • Write

    Create Custom Field

    Create a new custom field in the account. :::info Requires the customfields:write OAuth2 scope. :::

  • Write

    Update Custom Field

    Update 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.

  • Destructive

    Delete Custom Field

    Delete 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. :::info Requires the customfields:write OAuth2 scope. :::

Ideal Customer Profiles

  • Read

    Retrieve Ideal Customer Profiles

    Retrieve all Ideal Customer Profiles (ICPs) defined in the account. Each ICP is a saved set of company-level filter criteria (employee count, industry, location) used to identify target companies.

  • Read

    Retrieve Company ICP Matches

    Find 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. A company that matches no ICP keeps its place in the response with an empty list.

  • Read

    Get Ideal Customer Profile Details

    Get 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.

  • Write

    Create an Ideal Customer Profile

    Create a new Ideal Customer Profile (ICP) in the account. Creating an ICP also creates the custom feed that surfaces the companies matching it. Credit Note: Creating an ICP does not consume credits. :::info Requires the icps:write OAuth2 scope. :::

  • Write

    Update an Ideal Customer Profile

    Update an existing Ideal Customer Profile (ICP). All attributes are optional; only the attributes you send are changed. Sending filters replaces every category, not just the one you name.

  • Destructive

    Delete an Ideal Customer Profile

    Delete an ICP by its ID. This also deletes the custom feed created alongside it. :::info Requires the icps:write OAuth2 scope. :::

IP

  • Read

    Enrich Company IP Address

    Enriches an input IP (IPv4/IPv6) with matching company information (if any). Note: - This endpoint requires an active subscription to the IP Enrich product. - A request will only be counted as a successful match when the companytype attribute is set to company.

Lists

  • Read

    Retrieve Lists

    Retrieve all lists available in the account. The response includes each list's attributes and can be filtered through query parameters. Credit Note: Retrieving list definitions does not consume credits. :::info Requires the lists:read OAuth2 scope. :::

  • Read

    Get Batch Add to List Job

    Retrieve the status of a batch add-to-list job created via POST /v1/lists/batch-add-to-list-jobs. While status is running, results and summary are omitted.

  • Read

    Get Batch Remove from List Job

    Retrieve the status of a batch remove-from-list job created via POST /v1/lists/batch-remove-from-list-jobs. While status is running, results and summary are omitted.

  • Read

    Retrieve Company List Memberships

    Find 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.

  • Read

    Retrieve Contact List Memberships

    Find 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.

  • Read

    Get List Details

    Retrieve the details of a specific list using its unique ID. The response includes the list's attributes, such as its name and scope, along with any related information requested through query parameters.

  • Read

    Retrieve List Items

    Retrieve the members of a list. The list is addressed by its {id}, a scope-prefixed list identifier (e.g. company123 or contact456). There is a single List resource: the list's listtype determines whether the members are companies or contacts.

  • Write

    Create a List

    Create a new list in the account. :::info Requires the lists:write OAuth2 scope. :::

  • Write

    Create Batch Add to List Job

    Schedule an asynchronous job that adds members to a single list. The target list is identified by data.attributes.listid in the request body; the list's listtype determines whether company or contact references are accepted.

  • Write

    Create Batch Remove from List Job

    Schedule an asynchronous job that removes members from a single list. The target list is identified by data.attributes.listid in the request body; the list's listtype determines whether company or contact references are accepted.

  • Write

    Update List

    Update the name of a list. Credit Note: Updating list name does not consume credits. :::info Requires the lists:write OAuth2 scope. :::

  • Destructive

    Delete List

    Delete a list from the account. Once removed, the list will no longer be accessible. Credit Note: Deleting list does not consume credits. :::info Requires the lists:write OAuth2 scope. :::

Settings

  • Read

    Get Cookie Consent Settings

    Returns the account's cookie consent management state. :::info Requires the accounts:read OAuth2 scope. :::

  • Read

    Get Data Processing Settings

    Returns the current "Allow third-party providers" state for the account and its full change history, ordered most-recent-first. Each changelog entry records what was set, who set it, and when. :::info Requires the accounts:read OAuth2 scope. :::

  • Write

    Update Cookie Consent Settings

    Toggles cookie consent management for the account. When enabled, the Leadfeeder tracker does not set its cookie on page load until the visitor grants consent. Integration cookies cannot be modified through the API.

  • Write

    Update Data Processing Settings

    Enables or disables third-party data enrichment providers for the account. Disabling stops contact data enrichment via third-party providers. The change is recorded in the changelog with the acting API user's identity. :::info Requires the accounts:write OAuth2 scope. :::

Tags

  • Read

    Retrieve Tags

    Retrieve the list of all tags available in the account. The response contains all tag definitions, including their identifiers, display names, and colors, which can be used to classify or filter companies within the platform.

  • Read

    Get Batch Add Tags Job

    Retrieve the status of a batch add-tags job created via POST /v1/tags/batch-add-tags-jobs. While status is running, summary is omitted. Once status becomes completed, summary carries the outcome counts (including failedcount). On failed, errors describes the failure.

  • Read

    Get Batch Remove Tags Job

    Retrieve the status of a batch remove-tags job created via POST /v1/tags/batch-remove-tags-jobs. While status is running, summary is omitted. Once status becomes completed, summary carries the outcome counts (including failedcount). On failed, errors describes the failure.

  • Read

    Get Tag Details

    Fetch the details of a specific tag using its unique tag ID. Returns the tag’s attributes, including its name, color, and timestamps indicating when it was created and last updated. Credit Note: Retrieving tag data does not consume credits.

  • Write

    Create Tag

    Create a new tag with the provided attributes. This endpoint allows clients to define a new tag that can be assigned to companies. The response returns the full tag object, including its generated identifier and timestamps. Credit Note: Creating tags doe not consume credits.

  • Write

    Create Batch Add Tags Job

    Schedule an asynchronous job that adds the tags in data.attributes.tags to a set of companies. Every tag is added to every selected company.

  • Write

    Create Batch Remove Tags Job

    Schedule an asynchronous job that removes the tags in data.attributes.tags from a set of companies. Every tag is removed from every selected company.

  • Write

    Update Tag

    Update the attributes of a specific tag identified by its ID. This endpoint applies a partial update to a single tag. Only the fields provided in the request body will be modified; all other fields remain unchanged. Credit Note: Updating tags does not consume credits.

  • Destructive

    Delete Tag

    Delete 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. Credit Note: Deleting tags does not consume credits. :::info Requires the tags:write OAuth2 scope. :::

Usage

  • Read

    Get Endpoints Usage

    Access usage statistics for various API endpoints for monitoring and auditing purposes. Returns usage data for all endpoints accessible by the requesting account within the specified date range. :::info Requires the usage:read OAuth2 scope. :::

Users

  • Read

    Get Current User

    Retrieves the identity of the current API user - a "whoami" endpoint. Unlike most endpoints, this one does not require the accountid query parameter — the user's identity is independent of the account they are currently working on.

Web Visits

  • Read

    Search Web Visits

    Search for web visits within a date range. Returns a paginated list of visit records including engagement data, visitor information, and location. Visits can be narrowed with the simple inline filters or with a custom-feed-style advancedfilters tree (one or the other, not both).

  • Read

    Retrieve Visitor Companies

    Retrieve 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. Order the list with sort[field] and sort[direction].

  • Read

    Retrieve Custom Feeds

    Retrieve all custom feeds accessible to the current user for the given account. :::info Requires the webvisits:read OAuth2 scope. :::

  • Read

    Retrieve Custom Feeds Folders

    Retrieve all custom feed folders accessible to the current user for the given account. :::info Requires the webvisits:read OAuth2 scope. :::

  • Read

    Get Custom Feed Details

    Retrieve a single custom feed by its ID. :::info Requires the webvisits:read OAuth2 scope. :::

  • Read

    Retrieve Goals

    Retrieve all goals defined in the account. A goal is a page-view condition — on the page URL or title, a form submission, a file download or a video — that marks the page views signalling buying intent, such as visits to a pricing page.

  • Read

    Get Goal Details

    Get 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. :::info Requires the webvisits:read OAuth2 scope. :::

  • Read

    Retrieve Web Visits Tracker Script

    Retrieve 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. It also reports whether the script is actually sending data.

  • Write

    Create a Custom Feed

    Create a new custom feed for the given account. :::info Requires the webvisits:write OAuth2 scope. :::

  • Write

    Update Custom Feed

    Update an existing custom feed. All attributes are optional; only provided attributes will be updated. :::info Requires the webvisits:write OAuth2 scope. :::

  • Write

    Create a Goal

    Create a goal in the account. A goal only marks page views tracked after it is created; earlier visits are not re-checked. The goal's custom feed is created in the background, so relationships.customfeed is usually null in the response.

  • Write

    Update a Goal

    Update an existing goal. All attributes are optional; only the attributes you send are changed. criterion replaces the stored criterion: send its operator, and a value unless the operator is ispresent or isempty, which take none.

  • Destructive

    Delete a Custom Feed

    Delete a custom feed by its ID. :::info Requires the webvisits:write OAuth2 scope. :::

  • Destructive

    Delete a Goal

    Delete a goal by its ID. Its custom feed is deleted too, and the goal is removed from the page views it marked. The deletion completes in the background, so the goal can still be returned by the other goal endpoints for a short time; the request does not need retrying.

See How connections work for access and permissions, or browse all integrations.