Harmonic

Harmonic 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 reusable Harmonic team API key connection. It does not use delegated OAuth. You need an existing Harmonic workspace with API access; ask your Harmonic workspace administrator or Harmonic support for the team key, then create a Harmonic connection from the block's Harmonic Account field. Sim validates and stores the key once, then sends it only in Harmonic's apikey request header. The same connection can be reused across Harmonic blocks and replaced or revoked from the credentials settings.

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, then choose it with the basic selector. Advanced mode accepts a numeric saved-search ID or full URN when a search is not shown. 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. Get Company Employees returns URNs the same way, so account-based sourcing chains through the same step.
• Starting from an identifier: Enrich Person turns a LinkedIn profile URL or an email address into a contact. When Harmonic has no record yet it returns an error naming the enrichment it just scheduled; poll that URN with Get Enrichment Status and read the person once it completes.
• Net-new monitoring: Get People Saved Search Net-New Results returns only people who newly matched, which avoids reprocessing the whole result set on every poll. It requires a saved search you have subscribed to in the Harmonic console — there is no API to subscribe. Acknowledge what you processed with Clear People Saved Search Net-New Results so the next poll starts clean.
• Email enrichment: Submit Email Enrichment Job queues up to 5,000 people from either person URNs or LinkedIn URLs (one list or the other, never both). Poll Get Email Enrichment Job until isTerminal is true; the per-person rows carry a status but never an address, so pass succeededPersonUrns to Batch Get People to read the resolved emails. Check Get Email Enrichment Usage first to avoid exhausting the monthly quota.
• 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. A nullable array means Harmonic did not return that collection for the record; an empty array means Harmonic returned the collection with no values.
• Large batches: Batch Get People accepts at most 500 combined IDs and URNs and requests only the fields used by the normalized contact output. Exceptionally large profiles can still exceed Sim's response limit; retry with smaller batches if that occurs.
• 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 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.

Usage Instructions

Connect a reusable Harmonic team API key, use Scout to find people with natural-language criteria, select 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

Output

Harmonic Enrich Person

Resolve a LinkedIn profile URL or email address into a normalized Harmonic contact, queueing enrichment when the person is not yet in Harmonic.

Input

Output

Harmonic Get Person

Fetch one Harmonic person by numeric ID or URN, including any email resolved by a completed enrichment job.

Input

Output

Harmonic Batch Get People

Fetch full Harmonic person profiles for up to 500 combined numeric IDs and person URNs.

Input

Output

Harmonic Get Company Employees

List person URNs for a company, filtered by role group and employment status. Pair with Batch Get People to hydrate contacts.

Input

Output

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

Output

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

Output

Harmonic Get People Saved Search Net-New Results

Get only the people newly matching a subscribed Harmonic people saved search, so a monitor does not reprocess the whole result set.

Input

Output

Harmonic Clear People Saved Search Net-New Results

Acknowledge net-new people on a saved search so the next poll returns only fresh matches. Clearing everything requires setting the scope explicitly.

Input

Output

Harmonic Submit Email Enrichment Job

Queue bulk email enrichment for up to 5,000 people, given either person URNs or LinkedIn profile URLs.

Input

Output

Harmonic Get Email Enrichment Job

Check a Harmonic bulk email enrichment job. Per-person results appear once the job is terminal; fetch the emails with Get Person or Batch Get People.

Input

Output

Harmonic Get Email Enrichment Usage

Read the team monthly email-enrichment quota. Check this before a large batch to avoid a quota rejection.

Input

Output

Harmonic Get Enrichment Status

Check enrichment jobs Harmonic queued for people it did not already have, and read the person URN each one produced.

Input

Output