@superagnt/heyreach-outreach 2.0.6 → 2.0.7

package/README.md

@@ -12,9 +12,9 @@ This package is the official **OpenClaw** plugin for the **HeyReach** integratio
 
 ## What this plugin contains
 
-A fixed, baked-in toolset for the **HeyReach** endpoints below — nothing else. Calls run on the HeyReach account the user connected in their dashboard; the plugin does not change after install and adds no other platform surface. Where HeyReach supports destructive or outbound operations (deletes, updates, sending as the user), always confirm with the user before performing them.
+A fixed, baked-in toolset for the **HeyReach** endpoints below — nothing else. Calls run on the HeyReach account the user connected in the superagnt app; the plugin does not change after install and adds no other platform surface. Where HeyReach supports destructive or outbound operations (deletes, updates, sending as the user), always confirm with the user before performing them.
 
-Prefer MCP? The `@superagnt/superagnt` plugin connects the workspace MCP server instead, whose tool surface is managed by the user in the dashboard.
+Prefer MCP? The `@superagnt/superagnt` plugin connects the workspace MCP server instead, whose tool surface is managed by the user in the superagnt app.
 
 ## Overview
 
@@ -42,8 +42,8 @@ OpenClaw plugin for HeyReach LinkedIn outreach — manage campaigns, leads, lead
 
 ## Prerequisites
 
-1. A **superagnt API key** — create and manage keys in the [superagnt dashboard](https://app.superagnt.com/dashboard).
-2. A connected **HeyReach** account — configure in the [connections dashboard](https://app.superagnt.com/dashboard/connections).
+1. A **superagnt API key** — create and manage keys in the [superagnt app](https://app.superagnt.com/dashboard).
+2. A connected **HeyReach** account — configure on the [Connections page](https://app.superagnt.com/dashboard/connections).
 
 ## Authentication
 
@@ -55,14 +55,14 @@ Set `SUPERAGNT_API_KEY` in your environment, or complete browser login when the
 | --- | --- |
 | **Integration** | `heyreach` |
 | **REST base** | `https://api.superagnt.com/v1/connections/heyreach` |
-| **OpenAPI operations** | 59 |
-| **OpenClaw tools** | 59 |
+| **OpenAPI operations** | 84 |
+| **OpenClaw tools** | 84 |
 
 ## Documentation
 
 - [Documentation](https://superagnt.com/docs) — getting started and concepts
 - [Connection guide (HeyReach)](https://superagnt.com/docs) — setup and endpoints
-- [Dashboard](https://app.superagnt.com/dashboard) — API keys and usage
+- [superagnt app](https://app.superagnt.com/dashboard) — API keys and usage
 
 ## Related
 

package/index.js

@@ -115,23 +115,23 @@ export default function register(api) {
         "properties": {
             "offset": {
                 "type": "integer",
-                "description": "Zero-based offset into the result set."
+                "description": "Number of records to skip."
             },
             "limit": {
                 "type": "integer",
-                "description": "Maximum number of campaigns to return."
+                "description": "Page size, at most 100."
             },
             "keyword": {
                 "type": "string",
-                "description": "Optional free-text filter applied to campaign names."
+                "description": "Matches campaign names."
             },
             "statuses": {
                 "type": "array",
-                "description": "Optional list of campaign statuses to include."
+                "description": "Only campaigns in these statuses."
             },
             "accountIds": {
                 "type": "array",
-                "description": "Optional list of LinkedIn sender account IDs to filter campaigns by."
+                "description": "Only campaigns using these sender accounts."
             }
         }
     },
@@ -238,15 +238,39 @@ export default function register(api) {
         "properties": {
             "name": {
                 "type": "string",
-                "description": "Display name for the new campaign."
+                "description": "Campaign name, 1-50 characters."
             },
             "linkedInUserListId": {
                 "type": "integer",
-                "description": "ID of the existing lead list (`USER_LIST`) to back the campaign. Omit when the campaign should be created with an empty list to be populated via `/campaign/AddLeadsToCampaignV2`."
+                "description": "The lead list (`USER_LIST`) the campaign reads leads from."
             },
             "linkedInAccountIds": {
                 "type": "array",
-                "description": "IDs of the connected LinkedIn sender accounts that should run this campaign."
+                "description": "Sender accounts that run the campaign; each must be connected with valid auth."
+            },
+            "excludeContactedFromOtherCampaigns": {
+                "type": "boolean",
+                "description": "Skip leads already in any other campaign."
+            },
+            "excludeHasOtherAccConversations": {
+                "type": "boolean",
+                "description": "Skip leads who already have a conversation with another sender account."
+            },
+            "excludeContactedFromSenderInOtherCampaign": {
+                "type": "boolean",
+                "description": "Skip leads the campaign's senders already contacted from another campaign."
+            },
+            "excludeListId": {
+                "type": "integer",
+                "description": "A lead list whose members are always skipped; must differ from `linkedInUserListId`."
+            },
+            "excludeFromLeadBlacklist": {
+                "type": "boolean",
+                "description": "Skip leads on the workspace's lead blacklist (`/blacklist/GetLeads`)."
+            },
+            "excludeFromCompanyBlacklist": {
+                "type": "boolean",
+                "description": "Skip leads whose company is on the workspace's company blacklist (`/blacklist/GetCompanies`)."
             },
             "schedule": {
                 "type": "string",
@@ -259,9 +283,8 @@ export default function register(api) {
         },
         "required": [
             "name",
-            "linkedInAccountIds",
-            "schedule",
-            "sequence"
+            "linkedInUserListId",
+            "linkedInAccountIds"
         ]
     },
     execute: async (_toolCallId, input) => {
@@ -279,40 +302,49 @@ export default function register(api) {
         "properties": {
             "campaignIdForTemplate": {
                 "type": "integer",
-                "description": "ID of the existing campaign whose schedule/sequence/settings should be cloned."
+                "description": "The campaign whose sequence and schedule are copied."
             },
             "name": {
                 "type": "string",
-                "description": "Display name for the new campaign."
+                "description": "Campaign name, 1-50 characters."
             },
             "linkedInUserListId": {
                 "type": "integer",
-                "description": "ID of the lead list (`USER_LIST`) to back the new campaign."
+                "description": "The lead list (`USER_LIST`) for the new campaign."
             },
             "linkedInAcccountIdsForCampaign": {
                 "type": "array",
-                "description": "IDs of the connected LinkedIn sender accounts that should run the new campaign. (Note: spelling `linkedInAcccountIdsForCampaign` matches the upstream API.)"
+                "description": "Sender accounts that run the new campaign. (The triple `c` matches HeyReach's API.)"
             },
             "excludeContactedFromOtherCampaigns": {
                 "type": "boolean",
-                "description": "Skip leads that have been contacted by any other campaign in the workspace."
+                "description": "Skip leads already in any other campaign."
             },
             "excludeHasOtherAccConversations": {
                 "type": "boolean",
-                "description": "Skip leads who already have an open conversation with another connected LinkedIn account in the workspace."
+                "description": "Skip leads who already have a conversation with another sender account."
             },
             "excludeContactedFromSenderInOtherCampaign": {
                 "type": "boolean",
-                "description": "Skip leads previously contacted by this campaign's sender from any other campaign."
+                "description": "Skip leads the campaign's senders already contacted from another campaign."
             },
             "excludeListId": {
                 "type": "integer",
-                "description": "Optional ID of an exclusion list — leads present in this list will be skipped."
+                "description": "A lead list whose members are always skipped; must differ from `linkedInUserListId`."
+            },
+            "excludeFromLeadBlacklist": {
+                "type": "boolean",
+                "description": "Skip leads on the workspace's lead blacklist (`/blacklist/GetLeads`)."
+            },
+            "excludeFromCompanyBlacklist": {
+                "type": "boolean",
+                "description": "Skip leads whose company is on the workspace's company blacklist (`/blacklist/GetCompanies`)."
             }
         },
         "required": [
             "campaignIdForTemplate",
             "name",
+            "linkedInUserListId",
             "linkedInAcccountIdsForCampaign"
         ]
     },
@@ -331,35 +363,45 @@ export default function register(api) {
         "properties": {
             "campaignId": {
                 "type": "integer",
-                "description": "campaignId"
+                "description": "The campaign."
             },
             "name": {
                 "type": "string",
-                "description": "name"
+                "description": "Campaign name, 1-50 characters."
             },
             "linkedInUserListId": {
                 "type": "integer",
-                "description": "ID of the lead list backing this campaign."
+                "description": "The campaign's lead list (`USER_LIST`); send the current one to keep it."
             },
             "excludeContactedFromOtherCampaigns": {
                 "type": "boolean",
-                "description": "excludeContactedFromOtherCampaigns"
+                "description": "Skip leads already in any other campaign."
             },
             "excludeHasOtherAccConversations": {
                 "type": "boolean",
-                "description": "excludeHasOtherAccConversations"
+                "description": "Skip leads who already have a conversation with another sender account."
             },
             "excludeContactedFromSenderInOtherCampaign": {
                 "type": "boolean",
-                "description": "excludeContactedFromSenderInOtherCampaign"
+                "description": "Skip leads the campaign's senders already contacted from another campaign."
             },
             "excludeListId": {
                 "type": "integer",
-                "description": "Optional exclusion list ID. Pass `null` to clear."
+                "description": "A lead list whose members are always skipped; must differ from `linkedInUserListId`."
+            },
+            "excludeFromLeadBlacklist": {
+                "type": "boolean",
+                "description": "Skip leads on the workspace's lead blacklist (`/blacklist/GetLeads`)."
+            },
+            "excludeFromCompanyBlacklist": {
+                "type": "boolean",
+                "description": "Skip leads whose company is on the workspace's company blacklist (`/blacklist/GetCompanies`)."
             }
         },
         "required": [
-            "campaignId"
+            "campaignId",
+            "name",
+            "linkedInUserListId"
         ]
     },
     execute: async (_toolCallId, input) => {
@@ -423,6 +465,60 @@ export default function register(api) {
     },
   })
 
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_add_accounts',
+    description: "Add sender accounts to campaign",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "The campaign."
+            },
+            "linkedInAccountIds": {
+                "type": "array",
+                "description": "Sender accounts to add."
+            }
+        },
+        "required": [
+            "campaignId",
+            "linkedInAccountIds"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/AddLinkedInAccountsToCampaign', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_remove_accounts',
+    description: "Remove sender accounts from campaign",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "The campaign."
+            },
+            "linkedInAccountIds": {
+                "type": "array",
+                "description": "Sender accounts to remove."
+            }
+        },
+        "required": [
+            "campaignId",
+            "linkedInAccountIds"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/RemoveLinkedInAccountsFromCampaign', undefined, params)
+    },
+  })
+
   api.registerTool({
     name: 'superagnt_connection_heyreach_campaign_update_sequence',
     description: "Update campaign sequence",
@@ -458,7 +554,7 @@ export default function register(api) {
         "properties": {
             "campaignId": {
                 "type": "integer",
-                "description": "campaignId"
+                "description": "The campaign."
             }
         },
         "required": [
@@ -485,6 +581,14 @@ export default function register(api) {
             "accountLeadPairs": {
                 "type": "array",
                 "description": "List of `{ lead, linkedInAccountId }` pairs. `linkedInAccountId` selects which connected sender account should own the outreach for that lead and must be one of the campaign's assigned sender accounts."
+            },
+            "resumePausedCampaign": {
+                "type": "boolean",
+                "description": "When true and the campaign is `PAUSED`, HeyReach resumes the campaign before adding the leads. Send `false` unless the operator asked for a resume."
+            },
+            "resumeFinishedCampaign": {
+                "type": "boolean",
+                "description": "When true and the campaign is `FINISHED`, HeyReach resumes it before adding the leads."
             }
         },
         "required": [
@@ -515,11 +619,11 @@ export default function register(api) {
             },
             "resumeFinishedCampaign": {
                 "type": "boolean",
-                "description": "If true and the campaign is `FINISHED`, the API will resume it before appending leads."
+                "description": "When true and the campaign is `FINISHED`, HeyReach resumes it before adding the leads."
             },
             "resumePausedCampaign": {
                 "type": "boolean",
-                "description": "If true and the campaign is `PAUSED`, the API will resume it before appending leads."
+                "description": "When true and the campaign is `PAUSED`, HeyReach resumes the campaign before adding the leads. Send `false` unless the operator asked for a resume."
             }
         },
         "required": [
@@ -572,7 +676,7 @@ export default function register(api) {
         "properties": {
             "campaignId": {
                 "type": "integer",
-                "description": "campaignId"
+                "description": "The campaign."
             },
             "offset": {
                 "type": "integer",
@@ -580,7 +684,7 @@ export default function register(api) {
             },
             "limit": {
                 "type": "integer",
-                "description": "limit"
+                "description": "Page size, at most 100."
             },
             "timeFrom": {
                 "type": "string",
@@ -592,7 +696,7 @@ export default function register(api) {
             },
             "timeFilter": {
                 "type": "string",
-                "description": "Which lead timestamp `timeFrom`/`timeTo` apply to."
+                "description": "Which timestamp `timeFrom`/`timeTo` filter: `CreationTime`, `LastActionTakenTime`, `FailedTime`, `LastActionTakenOrFailedTime`, or `Everywhere` (no time filter, the default)."
             }
         },
         "required": [
@@ -641,6 +745,38 @@ export default function register(api) {
     },
   })
 
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_update_lead_fields',
+    description: "Update a campaign lead's custom fields",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "The campaign."
+            },
+            "leadMemberIdOrUrl": {
+                "type": "string",
+                "description": "The lead: its LinkedIn member id (`linkedin_id`) or its profile URL."
+            },
+            "customFields": {
+                "type": "object",
+                "description": "Field name → value. An existing field is updated, a new one created, and a null or empty value deletes the field. At most 100 fields; names up to 128 characters, values up to 2048."
+            }
+        },
+        "required": [
+            "campaignId",
+            "leadMemberIdOrUrl",
+            "customFields"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'PATCH', '/campaign/UpdateLeadCustomFields/campaigns/{campaignId}/leads/custom-fields', undefined, params)
+    },
+  })
+
   api.registerTool({
     name: 'superagnt_connection_heyreach_inbox_get_conversations_v2',
     description: "Get conversations",
@@ -649,15 +785,15 @@ export default function register(api) {
         "properties": {
             "offset": {
                 "type": "integer",
-                "description": "offset"
+                "description": "Number of records to skip."
             },
             "limit": {
                 "type": "integer",
-                "description": "limit"
+                "description": "Page size, at most 100."
             },
             "filters": {
                 "type": "object",
-                "description": "Optional filter object."
+                "description": "Optional filters."
             }
         }
     },
@@ -668,6 +804,41 @@ export default function register(api) {
     },
   })
 
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_inbox_get_conversations_v3',
+    description: "Get conversations (cursor-paged)",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "limit": {
+                "type": "integer",
+                "description": "Page size, at most 100."
+            },
+            "cursor": {
+                "type": "string",
+                "description": "The previous page's `nextCursor`; omit or null for the first page. An edited cursor is a 400."
+            },
+            "from": {
+                "type": "string",
+                "description": "Lower bound on `lastMessageAt` (UTC)."
+            },
+            "to": {
+                "type": "string",
+                "description": "Upper bound on `lastMessageAt` (UTC); defaults to now."
+            },
+            "filters": {
+                "type": "object",
+                "description": "Optional filters."
+            }
+        }
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/inbox/GetConversationsV3', undefined, params)
+    },
+  })
+
   api.registerTool({
     name: 'superagnt_connection_heyreach_inbox_get_chatroom',
     description: "Get chatroom (single conversation thread)",
@@ -680,7 +851,7 @@ export default function register(api) {
             },
             "conversationId": {
                 "type": "string",
-                "description": "Opaque conversation/chatroom identifier (as returned by `/inbox/GetConversationsV2`)."
+                "description": "The conversation's `id` (from `/inbox/GetConversationsV2` or `/inbox/GetConversationsV3`)."
             }
         },
         "required": [
@@ -707,11 +878,11 @@ export default function register(api) {
             },
             "subject": {
                 "type": "string",
-                "description": "Optional InMail subject line. Ignored for non-InMail threads."
+                "description": "Subject line; required by HeyReach and shown only in InMail threads."
             },
             "conversationId": {
                 "type": "string",
-                "description": "Opaque conversation/chatroom identifier (as returned by `/inbox/GetConversationsV2`)."
+                "description": "The conversation's `id`."
             },
             "linkedInAccountId": {
                 "type": "integer",
@@ -720,6 +891,7 @@ export default function register(api) {
         },
         "required": [
             "message",
+            "subject",
             "conversationId",
             "linkedInAccountId"
         ]
@@ -775,11 +947,11 @@ export default function register(api) {
             },
             "limit": {
                 "type": "integer",
-                "description": "limit"
+                "description": "Page size, at most 100."
             },
             "keyword": {
                 "type": "string",
-                "description": "Optional free-text filter applied to the account's display name."
+                "description": "Matches the account's name."
             }
         }
     },
@@ -812,6 +984,210 @@ export default function register(api) {
     },
   })
 
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_li_account_get_status',
+    description: "Get sender account connection status",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "accountId": {
+                "type": "integer",
+                "description": "The sender account."
+            }
+        },
+        "required": [
+            "accountId"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/li_account/GetAccountStatus/{accountId}', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_li_account_reconnect',
+    description: "Reconnect sender account",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "accountId": {
+                "type": "integer",
+                "description": "The sender account (`/li_account/GetAll`)."
+            }
+        },
+        "required": [
+            "accountId"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/li_account/Reconnect', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_li_account_relogin_navigator',
+    description: "Re-authenticate Sales Navigator",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "accountId": {
+                "type": "integer",
+                "description": "The sender account (`/li_account/GetAll`)."
+            }
+        },
+        "required": [
+            "accountId"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/li_account/ReloginSalesNavigator', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_li_account_relogin_recruiter',
+    description: "Re-authenticate Recruiter",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "accountId": {
+                "type": "integer",
+                "description": "The sender account (`/li_account/GetAll`)."
+            }
+        },
+        "required": [
+            "accountId"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/li_account/ReloginRecruiter', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_li_account_resync',
+    description: "Resync sender account profile",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "accountId": {
+                "type": "integer",
+                "description": "The sender account (`/li_account/GetAll`)."
+            }
+        },
+        "required": [
+            "accountId"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/li_account/Resync', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_li_account_get_proxy_countries',
+    description: "List proxy countries",
+    parameters: {
+        "type": "object",
+        "properties": {}
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/li_account/GetProxyCountries', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_li_account_update_proxy',
+    description: "Update sender account proxy",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "accountId": {
+                "type": "integer",
+                "description": "The sender account (`/li_account/GetAll`)."
+            },
+            "proxyCountryCode": {
+                "type": "string",
+                "description": "Country of the HeyReach-managed proxy, e.g. `US`."
+            }
+        },
+        "required": [
+            "accountId",
+            "proxyCountryCode"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/li_account/UpdateProxy', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_li_account_update_inbox_config',
+    description: "Update sender inbox sync",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "accountId": {
+                "type": "integer",
+                "description": "The sender account (`/li_account/GetAll`)."
+            },
+            "inboxScrapeMode": {
+                "type": "string",
+                "description": "inboxScrapeMode"
+            }
+        },
+        "required": [
+            "accountId",
+            "inboxScrapeMode"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/li_account/UpdateInboxConfiguration', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_li_account_remove',
+    description: "Remove sender account",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "accountId": {
+                "type": "integer",
+                "description": "The sender account."
+            },
+            "force": {
+                "type": "boolean",
+                "description": "Take the account off its active campaigns first."
+            }
+        },
+        "required": [
+            "accountId"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'DELETE', '/li_account/RemoveAccount/{accountId}', undefined, params)
+    },
+  })
+
   api.registerTool({
     name: 'superagnt_connection_heyreach_list_get_all',
     description: "List lead/company lists",
@@ -824,7 +1200,7 @@ export default function register(api) {
             },
             "limit": {
                 "type": "integer",
-                "description": "limit"
+                "description": "Page size, at most 100."
             },
             "keyword": {
                 "type": "string",
@@ -832,7 +1208,11 @@ export default function register(api) {
             },
             "listType": {
                 "type": "string",
-                "description": "Optional filter to restrict to lead lists or company lists."
+                "description": "Only lead lists (`USER_LIST`) or only company lists (`COMPANY_LIST`)."
+            },
+            "campaignIds": {
+                "type": "array",
+                "description": "Only lists used by these campaigns."
             }
         }
     },
@@ -877,7 +1257,7 @@ export default function register(api) {
             },
             "type": {
                 "type": "string",
-                "description": "Whether this list contains people (`USER_LIST`) or companies (`COMPANY_LIST`)."
+                "description": "`USER_LIST` for leads or `COMPANY_LIST` for companies."
             }
         },
         "required": [
@@ -908,7 +1288,7 @@ export default function register(api) {
             },
             "limit": {
                 "type": "integer",
-                "description": "limit"
+                "description": "Page size, at most 1000."
             },
             "keyword": {
                 "type": "string",
@@ -958,7 +1338,7 @@ export default function register(api) {
             },
             "limit": {
                 "type": "integer",
-                "description": "limit"
+                "description": "Page size, at most 1000."
             },
             "keyword": {
                 "type": "string",
@@ -1108,7 +1488,7 @@ export default function register(api) {
             },
             "limit": {
                 "type": "integer",
-                "description": "limit"
+                "description": "Page size, at most 1000."
             }
         }
     },
@@ -1119,6 +1499,38 @@ export default function register(api) {
     },
   })
 
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_list_update_lead_fields',
+    description: "Update a list lead's custom fields",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "listId": {
+                "type": "integer",
+                "description": "The lead list."
+            },
+            "leadMemberIdOrUrl": {
+                "type": "string",
+                "description": "The lead: its LinkedIn member id (`linkedin_id`) or its profile URL."
+            },
+            "customFields": {
+                "type": "object",
+                "description": "Field name → value. An existing field is updated, a new one created, and a null or empty value deletes the field. At most 100 fields; names up to 128 characters, values up to 2048."
+            }
+        },
+        "required": [
+            "listId",
+            "leadMemberIdOrUrl",
+            "customFields"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'PATCH', '/list/UpdateLeadCustomFields/lists/{listId}/leads/custom-fields', undefined, params)
+    },
+  })
+
   api.registerTool({
     name: 'superagnt_connection_heyreach_lead_get_by_profile_url',
     description: "Get lead by profile URL",
@@ -1253,6 +1665,201 @@ export default function register(api) {
     },
   })
 
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_blacklist_get_leads',
+    description: "List blacklisted leads",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "offset": {
+                "type": "integer",
+                "description": "Number of records to skip."
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Page size, at most 100."
+            },
+            "search": {
+                "type": "string",
+                "description": "Case-insensitive match on name, email, profile URL and LinkedIn member id."
+            },
+            "matchingStatus": {
+                "type": "string",
+                "description": "Only entries that resolved this way."
+            }
+        }
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/blacklist/GetLeads', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_blacklist_add_leads',
+    description: "Blacklist leads",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "leads": {
+                "type": "array",
+                "description": "1-100 entries, each with at least one identifier."
+            }
+        },
+        "required": [
+            "leads"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/blacklist/AddLeads', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_blacklist_remove_leads',
+    description: "Remove blacklisted leads",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "ids": {
+                "type": "array",
+                "description": "Entry ids, 1-100."
+            }
+        },
+        "required": [
+            "ids"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/blacklist/RemoveLeads', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_blacklist_get_companies',
+    description: "List blacklisted companies",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "offset": {
+                "type": "integer",
+                "description": "Number of records to skip."
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Page size, at most 100."
+            },
+            "search": {
+                "type": "string",
+                "description": "Case-insensitive match on company name and company URL."
+            },
+            "matchingStatus": {
+                "type": "string",
+                "description": "Only entries that resolved this way."
+            }
+        }
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/blacklist/GetCompanies', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_blacklist_add_companies',
+    description: "Blacklist companies",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "companies": {
+                "type": "array",
+                "description": "1-100 entries, each with `url`, `name` or both."
+            }
+        },
+        "required": [
+            "companies"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/blacklist/AddCompanies', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_blacklist_remove_companies',
+    description: "Remove blacklisted companies",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "ids": {
+                "type": "array",
+                "description": "Entry ids, 1-100."
+            }
+        },
+        "required": [
+            "ids"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/blacklist/RemoveCompanies', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_enrich_email',
+    description: "Start an email enrichment",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "profileUrl": {
+                "type": "string",
+                "description": "The lead's LinkedIn profile URL."
+            },
+            "leadMemberId": {
+                "type": "string",
+                "description": "An existing lead's `linkedin_id`."
+            }
+        }
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/enrichment/enrich-email', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_enrich_email_check_job',
+    description: "Check an email enrichment",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "jobId": {
+                "type": "integer",
+                "description": "The `jobId` from `/enrichment/enrich-email`."
+            }
+        },
+        "required": [
+            "jobId"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/enrichment/enrich-email/check-job/{jobId}', params)
+    },
+  })
+
   api.registerTool({
     name: 'superagnt_connection_heyreach_stats_get_overall',
     description: "Get overall stats",
@@ -1269,13 +1876,17 @@ export default function register(api) {
             },
             "campaignIds": {
                 "type": "array",
-                "description": "Restrict the aggregation to these campaign IDs."
+                "description": "The campaigns to count, or `[]` for every campaign. Required."
             },
             "accountIds": {
                 "type": "array",
-                "description": "Restrict the aggregation to these connected LinkedIn sender accounts."
+                "description": "The connected LinkedIn sender accounts to count, or `[]` for every sender. Required."
             }
-        }
+        },
+        "required": [
+            "accountIds",
+            "campaignIds"
+        ]
     },
     execute: async (_toolCallId, input) => {
       const key = ensureApiKey()
@@ -1300,13 +1911,17 @@ export default function register(api) {
             },
             "campaignIds": {
                 "type": "array",
-                "description": "campaignIds"
+                "description": "The campaigns to count, or `[]` for every campaign. Required."
             },
             "accountIds": {
                 "type": "array",
-                "description": "accountIds"
+                "description": "The connected LinkedIn sender accounts to count, or `[]` for every sender. Required."
             }
-        }
+        },
+        "required": [
+            "accountIds",
+            "campaignIds"
+        ]
     },
     execute: async (_toolCallId, input) => {
       const key = ensureApiKey()
@@ -1323,19 +1938,15 @@ export default function register(api) {
         "properties": {
             "senderId": {
                 "type": "integer",
-                "description": "ID of the connected LinkedIn sender account whose network should be returned."
+                "description": "The sender account (`/li_account/GetAll`)."
             },
-            "offset": {
+            "pageNumber": {
                 "type": "integer",
-                "description": "offset"
+                "description": "Zero-based page number."
             },
-            "limit": {
+            "pageSize": {
                 "type": "integer",
-                "description": "limit"
-            },
-            "keyword": {
-                "type": "string",
-                "description": "Optional free-text filter applied to first/last name and headline."
+                "description": "Page size, at most 100."
             }
         },
         "required": [
@@ -1387,7 +1998,7 @@ export default function register(api) {
         "properties": {
             "webhookName": {
                 "type": "string",
-                "description": "webhookName"
+                "description": "3-25 characters."
             },
             "webhookUrl": {
                 "type": "string",
@@ -1399,11 +2010,11 @@ export default function register(api) {
             },
             "campaignIds": {
                 "type": "array",
-                "description": "Optional — restrict to events originated by these campaigns. Empty/omitted means all campaigns."
+                "description": "Campaigns to listen to; empty or omitted means every campaign."
             },
             "customHeaders": {
-                "type": "object",
-                "description": "Optional custom HTTP headers to include on every webhook delivery (e.g. for authentication)."
+                "type": "array",
+                "description": "Extra HTTP headers HeyReach sends with each delivery, as `[{ name, value }]` (the shape `/webhooks/GetWebhookById` returns with `includeCustomHeaders`). HeyReach does not document them on writes: read the webhook back with `includeCustomHeaders: true` to confirm they were kept."
             }
         },
         "required": [
@@ -1457,7 +2068,7 @@ export default function register(api) {
             },
             "limit": {
                 "type": "integer",
-                "description": "limit"
+                "description": "Page size, at most 100."
             },
             "includeCustomHeaders": {
                 "type": "boolean",
@@ -1484,7 +2095,7 @@ export default function register(api) {
             },
             "webhookName": {
                 "type": "string",
-                "description": "webhookName"
+                "description": "3-25 characters."
             },
             "webhookUrl": {
                 "type": "string",
@@ -1500,11 +2111,11 @@ export default function register(api) {
             },
             "isActive": {
                 "type": "boolean",
-                "description": "isActive"
+                "description": "false pauses the webhook: HeyReach stops sending its events and the webhook can then be deleted (HeyReach refuses to delete an active one)."
             },
             "customHeaders": {
-                "type": "object",
-                "description": "customHeaders"
+                "type": "array",
+                "description": "Extra HTTP headers HeyReach sends with each delivery, as `[{ name, value }]` (the shape `/webhooks/GetWebhookById` returns with `includeCustomHeaders`). HeyReach does not document them on writes: read the webhook back with `includeCustomHeaders: true` to confirm they were kept."
             }
         },
         "required": [
@@ -1854,4 +2465,88 @@ export default function register(api) {
       return callSuperagnt(key, 'POST', '/management/organizations/users/invite/members', undefined, params)
     },
   })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_li_accounts_get_all',
+    description: "List sender accounts across workspaces",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "keyword": {
+                "type": "string",
+                "description": "Matches the account's name."
+            },
+            "workspaceIds": {
+                "type": "array",
+                "description": "Only these workspaces; empty or omitted means all."
+            },
+            "offset": {
+                "type": "integer",
+                "description": "Number of records to skip."
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Page size, at most 100."
+            }
+        }
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/management/organizations/linkedin-accounts', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_li_account_delete',
+    description: "Delete a sender account (organization)",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "linkedInAccountId": {
+                "type": "integer",
+                "description": "The sender account."
+            },
+            "forceDelete": {
+                "type": "boolean",
+                "description": "Take the account off its active campaigns first."
+            }
+        },
+        "required": [
+            "linkedInAccountId"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'DELETE', '/management/organizations/linkedin-accounts/{linkedInAccountId}', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_li_account_move',
+    description: "Move a sender account to another workspace",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "linkedInAccountId": {
+                "type": "integer",
+                "description": "The sender account."
+            },
+            "workspaceId": {
+                "type": "integer",
+                "description": "The destination workspace."
+            }
+        },
+        "required": [
+            "linkedInAccountId",
+            "workspaceId"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/management/organizations/linkedin-accounts/MoveToWorkspace', undefined, params)
+    },
+  })
 }

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "heyreach-outreach",
   "name": "HeyReach Integration",
   "description": "OpenClaw plugin for HeyReach LinkedIn outreach — manage campaigns, leads, lead lists, conversations, and analytics with your superagnt API key.",
-  "version": "2.0.6",
+  "version": "2.0.7",
   "contracts": {
     "tools": [
       "superagnt_connection_heyreach_auth_check_api_key",
@@ -16,6 +16,8 @@
       "superagnt_connection_heyreach_campaign_update_settings",
       "superagnt_connection_heyreach_campaign_update_schedule",
       "superagnt_connection_heyreach_campaign_update_accounts",
+      "superagnt_connection_heyreach_campaign_add_accounts",
+      "superagnt_connection_heyreach_campaign_remove_accounts",
       "superagnt_connection_heyreach_campaign_update_sequence",
       "superagnt_connection_heyreach_campaign_get_sequence",
       "superagnt_connection_heyreach_campaign_add_leads_v2",
@@ -23,12 +25,23 @@
       "superagnt_connection_heyreach_campaign_stop_lead",
       "superagnt_connection_heyreach_campaign_get_leads",
       "superagnt_connection_heyreach_campaign_get_for_lead",
+      "superagnt_connection_heyreach_campaign_update_lead_fields",
       "superagnt_connection_heyreach_inbox_get_conversations_v2",
+      "superagnt_connection_heyreach_inbox_get_conversations_v3",
       "superagnt_connection_heyreach_inbox_get_chatroom",
       "superagnt_connection_heyreach_inbox_send_message",
       "superagnt_connection_heyreach_inbox_set_seen_status",
       "superagnt_connection_heyreach_li_account_get_all",
       "superagnt_connection_heyreach_li_account_get_by_id",
+      "superagnt_connection_heyreach_li_account_get_status",
+      "superagnt_connection_heyreach_li_account_reconnect",
+      "superagnt_connection_heyreach_li_account_relogin_navigator",
+      "superagnt_connection_heyreach_li_account_relogin_recruiter",
+      "superagnt_connection_heyreach_li_account_resync",
+      "superagnt_connection_heyreach_li_account_get_proxy_countries",
+      "superagnt_connection_heyreach_li_account_update_proxy",
+      "superagnt_connection_heyreach_li_account_update_inbox_config",
+      "superagnt_connection_heyreach_li_account_remove",
       "superagnt_connection_heyreach_list_get_all",
       "superagnt_connection_heyreach_list_get_by_id",
       "superagnt_connection_heyreach_list_create_empty",
@@ -39,11 +52,20 @@
       "superagnt_connection_heyreach_list_delete_leads",
       "superagnt_connection_heyreach_list_delete_leads_by_url",
       "superagnt_connection_heyreach_list_get_for_lead",
+      "superagnt_connection_heyreach_list_update_lead_fields",
       "superagnt_connection_heyreach_lead_get_by_profile_url",
       "superagnt_connection_heyreach_lead_add_tags",
       "superagnt_connection_heyreach_lead_replace_tags",
       "superagnt_connection_heyreach_lead_get_tags",
       "superagnt_connection_heyreach_lead_tags_create",
+      "superagnt_connection_heyreach_blacklist_get_leads",
+      "superagnt_connection_heyreach_blacklist_add_leads",
+      "superagnt_connection_heyreach_blacklist_remove_leads",
+      "superagnt_connection_heyreach_blacklist_get_companies",
+      "superagnt_connection_heyreach_blacklist_add_companies",
+      "superagnt_connection_heyreach_blacklist_remove_companies",
+      "superagnt_connection_heyreach_enrich_email",
+      "superagnt_connection_heyreach_enrich_email_check_job",
       "superagnt_connection_heyreach_stats_get_overall",
       "superagnt_connection_heyreach_stats_get_by_campaign",
       "superagnt_connection_heyreach_network_get_for_sender",
@@ -63,7 +85,10 @@
       "superagnt_connection_heyreach_org_workspace_users_get_all",
       "superagnt_connection_heyreach_org_invite_admins",
       "superagnt_connection_heyreach_org_invite_managers",
-      "superagnt_connection_heyreach_org_invite_members"
+      "superagnt_connection_heyreach_org_invite_members",
+      "superagnt_connection_heyreach_org_li_accounts_get_all",
+      "superagnt_connection_heyreach_org_li_account_delete",
+      "superagnt_connection_heyreach_org_li_account_move"
     ]
   },
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superagnt/heyreach-outreach",
-  "version": "2.0.6",
+  "version": "2.0.7",
   "type": "module",
   "description": "OpenClaw plugin for HeyReach LinkedIn outreach — manage campaigns, leads, lead lists, conversations, and analytics with your superagnt API key.",
   "main": "index.js",