feat(harmonic): add contact workflow integration

Author: Bill Leoutsakos

apps/docs/components/icons.tsx

@@ -563,6 +563,28 @@ export function ChartBarIcon(props: SVGProps<SVGSVGElement>) {
   )
 }
 
+export function HarmonicIcon(props: SVGProps<SVGSVGElement>) {
+  return (
+    <svg {...props} viewBox='0 1 26 30.1' fill='none' role='img' xmlns='http://www.w3.org/2000/svg'>
+      {/** svg-path-precision-exception: Preserves Harmonic's supplied brand-mark coordinates. */}
+      <path
+        d='M6.49743 1.08252L12.9949 4.83381V12.3364L6.49743 16.0877L0 12.3364V4.83381L6.49743 1.08252Z'
+        fill='#FE5D45'
+      />
+      {/** svg-path-precision-exception: Preserves Harmonic's supplied brand-mark coordinates. */}
+      <path
+        d='M6.49743 16.0874L12.9949 19.8387V27.3413L6.49743 31.0926L0 27.3413V19.8387L6.49743 16.0874Z'
+        fill='#FE5D45'
+      />
+      {/** svg-path-precision-exception: Preserves Harmonic's supplied brand-mark coordinates. */}
+      <path
+        d='M19.5026 8.58496L26 12.3363V19.8388L19.5026 23.5901L13.0051 19.8388V12.3363L19.5026 8.58496Z'
+        fill='#FE5D45'
+      />
+    </svg>
+  )
+}
+
 export function HubspotIcon(props: SVGProps<SVGSVGElement>) {
   return (
     <svg

apps/docs/components/ui/icon-mapping.ts

@@ -112,6 +112,7 @@ import {
   GranolaIcon,
   GreenhouseIcon,
   GreptileIcon,
+  HarmonicIcon,
   HexIcon,
   HubspotIcon,
   HuggingFaceIcon,
@@ -393,6 +394,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
   granola: GranolaIcon,
   greenhouse: GreenhouseIcon,
   greptile: GreptileIcon,
+  harmonic: HarmonicIcon,
   hex: HexIcon,
   hubspot: HubspotIcon,
   huggingface: HuggingFaceIcon,

apps/docs/content/docs/en/integrations/harmonic.mdx

@@ -0,0 +1,192 @@
+---
+title: Harmonic
+description: Search and enrich private-market contacts
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+<BlockInfoCard 
+  type="harmonic"
+  color="#FFFFFF"
+/>
+
+{/* MANUAL-CONTENT-START:intro */}
+[Harmonic](https://harmonic.ai/) is a private-market intelligence platform for researching companies, people, and investors. Its Scout agent accepts a natural-language sourcing request—such as “find forward-deployed engineers in enterprise software”—and the Harmonic block converts the result into a predictable `contacts` table for downstream scoring, review, storage in Sim tables, or delivery to CRM and other integration blocks.
+
+### Authentication
+
+This integration uses a Harmonic **team API key**, sent only in the `apikey` request header. It does not use OAuth. You need an existing Harmonic workspace with API access; ask your Harmonic workspace administrator or [Harmonic support](mailto:support@harmonic.ai) for the team key, then paste it into the block's **Harmonic API Key** field.
+
+### Working with people data
+
+- **Scout search:** **Search People with Scout** uses an integration-owned schema so every successful request returns the same normalized contact fields. Scout task errors, timeouts, interruptions, and malformed structured results stop the workflow instead of returning an ambiguous partial result.
+- **Saved searches:** A team API key can read only saved searches shared with the team. Make a private people search shared in the Harmonic console before retrieving it through the API. Follow `pageInfo.nextCursor` while `pageInfo.hasNext` is true.
+- **URN-only rows:** Saved-search pages may contain person URNs without full profiles. Pass `personUrns` to **Batch Get People** to hydrate them into the common contact shape.
+- **Downstream workflows:** Pass `contacts` directly into Sim tables, scoring or approval steps, and other integrations such as a CRM. Every contact-producing action uses the same camelCase output shape.
+- **Workspace and list APIs:** This first version intentionally omits Harmonic's retiring V1 workspace and people-list endpoints. Harmonic says those APIs stop serving traffic on November 5, 2026 and already fail after a workspace completes its V2 migration. See Harmonic's [Workspace API migration guide](https://console.harmonic.ai/docs/api-reference/workspace/migration) for the V2 GraphQL replacement.
+
+Harmonic recommends no more than 100 saved-search results per page. Its general API limit is 10 requests per second, while Scout task creation is limited to 10 requests per minute and 100 per hour. Endpoint and field availability can also depend on your Harmonic subscription.
+
+Harmonic does not publish a webhook-registration contract for this workflow surface, so the integration has no native triggers. Use a **Schedule** block to poll a shared saved search when recurring synchronization is needed.
+{/* MANUAL-CONTENT-END */}
+
+
+## Usage Instructions
+
+Use Harmonic Scout to find people with natural-language criteria, retrieve team-visible people saved searches, and hydrate person identifiers into normalized contacts for downstream tables, CRM, scoring, and outreach workflows.
+
+
+
+## Actions
+
+### Harmonic Search People with Scout
+
+Ask Harmonic Scout to find people using natural language and return a stable, workflow-ready contacts table.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Yes | Harmonic team API key, sent in the apikey header |
+| `query` | string | Yes | Natural-language people research request, e.g. "Find forward-deployed engineers in enterprise software" |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `contacts` | array | People matching the Scout request, normalized for downstream workflow use |
+|   ↳ `personUrn` | string | Harmonic person URN |
+|   ↳ `personId` | number | Numeric Harmonic person ID |
+|   ↳ `fullName` | string | Full name |
+|   ↳ `firstName` | string | First name |
+|   ↳ `lastName` | string | Last name |
+|   ↳ `headline` | string | LinkedIn headline or current title |
+|   ↳ `currentTitles` | array | Current job titles |
+|   ↳ `currentCompanyNames` | array | Current company names |
+|   ↳ `currentCompanyUrns` | array | Current Harmonic company URNs |
+|   ↳ `primaryEmail` | string | Primary known email address |
+|   ↳ `emails` | array | Known email addresses |
+|   ↳ `phoneNumbers` | array | Known phone numbers |
+|   ↳ `linkedinUrl` | string | LinkedIn profile URL |
+|   ↳ `formattedLocation` | string | Formatted location |
+|   ↳ `city` | string | City |
+|   ↳ `state` | string | State or region |
+|   ↳ `country` | string | Country |
+|   ↳ `profilePictureUrl` | string | Profile picture URL |
+|   ↳ `summary` | string | Scout-generated contact summary |
+|   ↳ `isRedacted` | boolean | Whether Harmonic marks the person record as redacted |
+| `taskId` | string | Harmonic Scout task identifier |
+| `status` | string | Final Scout task status \(success\) |
+| `count` | number | Number of contacts returned |
+
+### Harmonic List People Saved Searches
+
+List the team-shared Harmonic saved searches that target people. Use a returned ID or URN to fetch results.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Yes | Harmonic team API key, sent in the apikey header |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `savedSearches` | array | Team-accessible Harmonic saved searches that target people |
+|   ↳ `savedSearchId` | number | Saved search ID |
+|   ↳ `savedSearchUrn` | string | Saved search URN |
+|   ↳ `name` | string | Saved search name |
+|   ↳ `isPrivate` | boolean | Whether the search is private |
+|   ↳ `savedSearchType` | string | Saved search entity type |
+|   ↳ `userSavedSearchType` | string | User-facing saved search type |
+|   ↳ `creatorUrn` | string | Creator user URN |
+|   ↳ `createdAt` | string | Creation timestamp |
+|   ↳ `updatedAt` | string | Last update timestamp |
+| `count` | number | Number of people saved searches returned |
+
+### Harmonic Get People Saved Search Results
+
+Get one page of a Harmonic people saved search. Full records become contacts; URN-only rows are exposed for Batch Get People.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Yes | Harmonic team API key, sent in the apikey header |
+| `savedSearchId` | string | Yes | People saved-search ID or full Harmonic saved-search URN |
+| `size` | number | No | Results to return, 1-100 \(default 50\) |
+| `cursor` | string | No | Opaque next-page cursor from a previous response |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `contacts` | array | Full person records returned by the saved search, normalized as contacts |
+|   ↳ `personUrn` | string | Harmonic person URN |
+|   ↳ `personId` | number | Numeric Harmonic person ID |
+|   ↳ `fullName` | string | Full name |
+|   ↳ `firstName` | string | First name |
+|   ↳ `lastName` | string | Last name |
+|   ↳ `headline` | string | LinkedIn headline or current title |
+|   ↳ `currentTitles` | array | Current job titles |
+|   ↳ `currentCompanyNames` | array | Current company names |
+|   ↳ `currentCompanyUrns` | array | Current Harmonic company URNs |
+|   ↳ `primaryEmail` | string | Primary known email address |
+|   ↳ `emails` | array | Known email addresses |
+|   ↳ `phoneNumbers` | array | Known phone numbers |
+|   ↳ `linkedinUrl` | string | LinkedIn profile URL |
+|   ↳ `formattedLocation` | string | Formatted location |
+|   ↳ `city` | string | City |
+|   ↳ `state` | string | State or region |
+|   ↳ `country` | string | Country |
+|   ↳ `profilePictureUrl` | string | Profile picture URL |
+|   ↳ `summary` | string | Scout-generated contact summary |
+|   ↳ `isRedacted` | boolean | Whether Harmonic marks the person record as redacted |
+| `personUrns` | array | All person URNs in the page, including rows returned without full profiles |
+| `totalCount` | number | Total matching people |
+| `pageInfo` | object | Cursor pagination metadata |
+|   ↳ `nextCursor` | string | Cursor for the next page |
+|   ↳ `currentCursor` | string | Cursor for the current page |
+|   ↳ `hasNext` | boolean | Whether another page is available |
+
+### Harmonic Batch Get People
+
+Fetch full Harmonic person profiles for up to 500 combined numeric IDs and person URNs.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Yes | Harmonic team API key, sent in the apikey header |
+| `personIds` | json | No | Array of numeric Harmonic person IDs; may be a JSON-array string |
+| `personUrns` | json | No | Array of Harmonic person URNs; may be a JSON-array string |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `contacts` | array | Fetched Harmonic person profiles normalized as contacts |
+|   ↳ `personUrn` | string | Harmonic person URN |
+|   ↳ `personId` | number | Numeric Harmonic person ID |
+|   ↳ `fullName` | string | Full name |
+|   ↳ `firstName` | string | First name |
+|   ↳ `lastName` | string | Last name |
+|   ↳ `headline` | string | LinkedIn headline or current title |
+|   ↳ `currentTitles` | array | Current job titles |
+|   ↳ `currentCompanyNames` | array | Current company names |
+|   ↳ `currentCompanyUrns` | array | Current Harmonic company URNs |
+|   ↳ `primaryEmail` | string | Primary known email address |
+|   ↳ `emails` | array | Known email addresses |
+|   ↳ `phoneNumbers` | array | Known phone numbers |
+|   ↳ `linkedinUrl` | string | LinkedIn profile URL |
+|   ↳ `formattedLocation` | string | Formatted location |
+|   ↳ `city` | string | City |
+|   ↳ `state` | string | State or region |
+|   ↳ `country` | string | Country |
+|   ↳ `profilePictureUrl` | string | Profile picture URL |
+|   ↳ `summary` | string | Scout-generated contact summary |
+|   ↳ `isRedacted` | boolean | Whether Harmonic marks the person record as redacted |
+| `count` | number | Number of contacts returned |
+
+

apps/docs/content/docs/en/integrations/meta.json

@@ -114,6 +114,7 @@
     "granola",
     "greenhouse",
     "greptile",
+    "harmonic",
     "hex",
     "hubspot",
     "hubspot-service-account",