What looks wrong?

We say this article was researched and checked. If it is wrong, we want the counter-example.

Skip to content
Activepieces

Sep 26, 202613 min read

Building a robust referral engine requires more than just a large contact list; it demands a systematic approach to identifying and facilitating high-value connections.

By leveraging modern workflow tools, including open-source options like Activepieces to sync data between platforms, professionals can transform their static LinkedIn networks into dynamic pipelines for warm introductions.

The key lies in mapping out the specific triggers that signal a mutual benefit, ensuring that every outreach feels personalized rather than automated. When executed correctly, this strategy reduces the friction of networking while significantly increasing the conversion rate of new business opportunities.

Automating warm introductions with relationship intelligence data

The shift from cold outreach to relationship graphs

Warm introductions have transitioned from a manual research task to a data-driven workflow. Relationship graphs now identify the path of least resistance to a prospect. Instead of a sales representative spending twenty minutes scouring LinkedIn mutuals, a centralized utility queries your internal and external networks.

Surfacing the specific colleague who can provide an endorsement is the primary function of this utility.

This shift moves relationship intelligence out of the "nice to have" category and into the core logic of your go-to-market engine. Every outreach attempt relies on a verified social connection.

By positioning the utility at the center, you avoid the fragmentation that occurs when a single user's inbox or a static spreadsheet holds relationship data.

How Village.ai builds its relationship graph

Village.ai functions as a specialized relationship graph provider that programmatically identifies who knows whom across global professional networks. To make this data actionable, the platform assigns specific credit costs to different levels of intelligence.

16 credits is the cost of building a list of 25 prospects according to the Village pricing page. You can generate a targeted outbound cohort for less than the cost of a single manual lead-gen tool subscription.

Village API Credit Cost per Action

Executing an AI search to return 10 high-intent results requires 6 credits. This allows for rapid iteration of ideal customer profiles without draining your monthly budget on broad queries.

5 credits is the price of identifying specific warm intro paths to a person, replacing hours of manual sleuthing with a single API call.

Enriching a profile in real-time or revealing a verified email address costs 1 credit each. This provides accurate contact data for the final mile of outreach rather than stale database records.

The request-response architecture of modern data APIs

Modern relationship intelligence operates through a request-response model. A workflow pulls data only when a specific decision requires it, such as whether to send an automated email or escalate to a phone call.

Activepieces manages these data points as discrete steps within a larger sequence, placing an Agent step alongside deterministic automation steps inside one flow definition rather than two products bridged by a webhook.

A workflow diagram showing a single flow definition where a rectangular Agent step is placed directly alongside a square…

The integration for Village currently offers 40 distinct actions but 0 triggers according to the Activepieces library. The system responds to your workflow's needs rather than interrupting it with unsolicited pings.

This architecture ensures that relationship data remains a utility called at the moment of need. It isn't a separate destination that requires its own monitoring and management.

This takes minutes, not a project: automate it in Activepieces free.

The unit economics of relationship intelligence

Granular, credit-based pricing models transform relationship data from a fixed overhead expense into a variable utility cost.

You ensure that you consume your budget only when you actively invoke the data utility to support a specific workflow decision. This shift moves away from the traditional SaaS model of paying for monthly seats regardless of activity.

Granular, credit-based pricing models transform relationship data from a fixed overhead expense into a variable utility cost.

How Village credits are priced and used

The Village credit system is the universal currency for relationship intelligence. It allows you to allocate resources across different API-driven tasks without managing multiple subscription tiers.

Because the system consumes credits at the point of request, a developer can programmatically control spend based on the priority of a specific lead or account.

Paying for full access for a hundred users even if only ten are active is a common enterprise software problem that this architecture prevents.

By treating intelligence as a metered resource, the cost of maintaining a clean CRM is a predictable line item tied to data freshness rather than headcount.

Village credit costs by action type

Different relationship intelligence actions carry different computational weights, and the pricing structure reflects the specific value delivered at each stage of the sales cycle.

The following table illustrates how costs are distributed between broad market identification and the high-value task of identifying a warm introduction path:

Action Type Resource Intensity Economic Consequence
Bulk List Enrichment Low You can refresh thousands of records for a nominal cost, ensuring your sales pipeline never contains stale contact data.
Relationship Path Mapping High Higher credit costs are reserved for late-stage deals where identifying a mutual connection significantly increases the probability of a meeting.
Real-time Signal Monitoring Medium Costs are incurred only when a specific trigger event occurs, preventing budget waste on static accounts that aren't currently in a buying window.

As the cost of generic attention continues to rise, the ability to buy only the specific intelligence required to bypass the "cold" barrier becomes a competitive necessity.

Village's nothing found, nothing charged pricing

A "nothing found, nothing charged" policy eliminates the financial risk of exploring niche markets or dormant accounts where data coverage might be thin.

In traditional data procurement, a firm pays a flat fee for access to a database. You effectively pay for every "null" result or incorrect record you encounter.

A "nothing found, nothing charged" policy eliminates the financial risk of exploring niche markets or dormant accounts where data coverage might be thin.

When the API successfully returns a verified data point or a valid relationship path, the utility-based credit model debits the balance.

This ensures that you map every dollar spent to a tangible asset. Your growth teams can run experimental automations across millions of records without the fear of a catastrophic bill for unsuccessful queries.

Four high-impact moments to wire relationship data

Relationship intelligence earns its keep when it is called at the specific moments where a team would otherwise spend hours guessing.

By embedding Village data directly into the tools where you already live, you replace manual "who knows who" searches with automated, high-probability paths to revenue.

Instant intro routing for new CRM accounts

Wiring relationship data into the lead ingest workflow ensures that every new prospect is immediately mapped to the strongest internal advocate.

This happens before a cold outreach attempt can fail. When a new record enters a customer relationship management (CRM) platform like Salesforce, the system queries the Village API to identify existing bridges among 4.77 billion verified relationships.

Social proximity, rather than arbitrary territory rules, determines how the system routes the lead. This prevents the "cold start" problem where a Sales Development Representative (SDR) calls a prospect who is already a close personal contact of a company executive.

  • Check for warm paths before assigning to SDRs to ensure the first touchpoint is an introduction rather than an interruption during CRM lead ingest.
  • Notify account owners when a path is returned with a confidence score above 0.9 via Slack or Teams alerts.

These triggers ensure that the most valuable data is surfaced exactly when a human needs to act on it.

Prioritizing accounts with Village connection data

Prioritizing outbound efforts based on relationship density allows your growth teams to focus resources on accounts with the highest mathematical probability of a response. By running a bulk query across 52 million companies indexed by Village, your marketing teams can reorder their target account lists.

Firms where employees share mutual connections rise to the top. This shift means a "Tier 1" account is defined by how easily you can break in, rather than just the size of the prospect's budget.

Automating backchannel references in the ATS

Integrating relationship intelligence into an Applicant Tracking System (ATS) like Greenhouse surfaces unofficial references who can provide a more honest assessment of a candidate.

As a candidate moves to the interview stage, the system scans 775 million people to find former colleagues who now work at your firm. Hiring managers can get a "backchannel" perspective before the final offer.

This reduces the risk of expensive mis-hires by using the collective network of your entire existing workforce.

Maintaining network currency with bulk overnight syncs

Scheduled data refreshes ensure that the relationship graph remains accurate even as employees change jobs or companies undergo mergers. An overnight synchronization process updates the connection scores for every record in the database.

If the primary bridge person leaves the company, a "warm" lead from six months ago is automatically downgraded. This persistent hygiene means that when you log in, you're never acting on stale social capital that no longer exists.

A gardener in a business suit using a pair of shears to snip a single, wilting vine off a lush green wall of foliage, while…

You can follow the rest of this with the builder open. Start free, no card.

Building the workflow with Activepieces and Village

Activepieces routes relationship intelligence directly into your existing communication stacks using its 732 integrations, transforming a static database into a functional utility.

It triggers specific data lookups only when a business event occurs. By using this open-source automation builder, you can embed Village’s relationship data directly into your existing communication stacks. This treats relationship insights as a real-time service rather than a destination.

Authenticating the Village integration

Connecting the Village data utility to a workflow requires a secure API handshake within the Activepieces "Connections" manager.

Every automated request is authorized against your specific organizational graph. Once the API key is stored, the builder can pull live relationship paths without requiring you to re-authenticate for individual steps.

This centralized credential management ensures that if a key is rotated, the entire workflow remains functional without manual updates to every node.

Using check_company_paths to filter accounts

The most efficient way to utilize relationship intelligence is to use the check_company_paths action as a gatekeeper.

The system only consumes heavy compute resources when a warm path actually exists. Instead of running a full enrichment on every inbound lead, the workflow uses this lightweight check to see if any internal employee has a connection to the target domain.

By placing this check immediately after the Gmail trigger, the system filters out cold leads before they reach the more expensive AI processing steps.

This sequence prevents the "Ask AI" steps from running on leads where no relationship leverage exists. This focus directs your automation's budget to the best opportunities.

Batching lookups with bulk endpoints

When dealing with large lists of prospects, using bulk endpoints allows the workflow to process multiple relationship queries in a single request.

Activepieces exposes every connector as an agent tool via its per-project MCP server, meaning the same Village integration action that runs in a flow is reachable from an agent without a second migration.

This batching approach prevents the workflow from hitting rate limits that would otherwise stall a high-volume outbound campaign.

Preserving the human element in the final outreach

Even the most intelligent data utility requires a human-in-the-loop step to ensure that the final outreach feels personal rather than algorithmic.

In the builder canvas, the "Request Approval" step sends the drafted message and the discovered relationship path to a Slack channel for a team member to review.

By requiring a manual click to "Approve" or "Edit" before the email is sent, you ensure that the "relationship" part of relationship intelligence isn't lost to total automation.

Frequently asked questions

How often does Village refresh its relationship data?

Village refreshes on two clocks. Your own network syncs continuously from the accounts you connect — Gmail, Outlook, Google Calendar and LinkedIn — so first-degree data keeps up with you without anything to manage. The wider public graph refreshes on a rolling basis: Village reports more than 214 million profiles updated in the last ninety days.

When a workflow needs the current state of one specific person rather than the stored version, a realtime enrichment call costs a single credit. Any profile Village has refreshed within the last three months is served free, so the ordinary path costs nothing and you pay only where freshness genuinely matters.

In practice that means a scheduled overnight job keeps a list broadly current, and the realtime call is the one you reach for at the moment somebody is about to send a message.

Can I import private contacts that aren't on LinkedIn?

You can ingest private contact data through secure integrations with email providers and calendar tools to capture relationships that exist outside of public social media profiles.

This capability allows the system to map "hidden" networks, such as long-standing personal mentors or former colleagues who maintain a low digital footprint.

By indexing the frequency and recency of direct interactions within a private communication suite, the system identifies high-strength bonds that a public-only scraper would miss.

This ensures that the most influential paths to a target account are visible to you, even if those connections have never been formalized on a public job board.

Does automating lookups risk burning bridge relationships?

Automating the lookup process identifies the strongest path to a lead without removing the human gatekeeper who must ultimately approve the outreach.

The system provides intelligence rather than executing unvetted communication.

Social capital of the "bridge" person who holds the relationship is preserved this way.

By surfacing the strongest connection first and requiring a manual check, the workflow prevents the "spamming" of mutual contacts for low-value introductions.

This structured approach ensures that high-value relationships are only leveraged for high-priority opportunities, maintaining the trust that makes a network valuable.

What is the difference between a second and third-degree path?

A second-degree path represents a direct mutual connection, while a third-degree path introduces an additional intermediary between you and the target.

When you and the target both know the same person, you have a second-degree path.

This allows for a direct request for an introduction. A third-degree path means your contact knows someone who knows the target, requiring two layers of social permission to reach the destination.

Distinguishing between these levels allows you to prioritize outreach based on the probability of a successful introduction. A second-degree connection is a high-confidence path where the social friction is low. A third-degree path is a tertiary option used only when no direct mutual ties exist.

Share

Build it

Set this up in minutes.

No code required. Connect your accounts, and Activepieces runs it from there.

Start free Talk to sales