Village

Overview

Connect Village with Flows360

The Social Capital API

Use the Village connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 40 actions and no declared triggers.

Available actions

• Get App Information
• Check Company Paths
• Refresh Companies
• Enrich Company
• Enrich Company (Bulk)
• Get Company Paths
• List Companies
• Search Companies
• Plus 32 additional declared actions.

Available triggers

• No triggers are declared in this pinned package.

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

• Connector: Village
• Package: @activepieces/piece-village@0.4.4
• Exact artifact digest: sha256:315f08d7b5491f20dd8706a0208253421b5fda4b14c12a6e4c26c959a45c618b
• Runtime: Activepieces-compatible deterministic worker
• Source: the exact reviewed Activepieces source

Authentication

SECRET TEXT. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

• Get App Information (get_app_info), Get information about the partner application associated with your token, title, description, domain, logo URL, public key, and active flag. Useful for verifying your app configuration. Classification: read.
• Check Company Paths (check_company_paths), Quickly check if you have connections to a company without fetching full details. Returns whether paths exist, an overall score, count of reachable people, and avatar thumbnails. Classification: read.
• Refresh Companies (companies_refresh), Refresh/import company data from LinkedIn URLs or domains. Realtime mode returns enriched data synchronously (or times out after 25s); async mode returns job IDs for later status checking. At least one of linkedin_urls or domains must be provided. Classification: read.
• Enrich Company (enrich_company), Get detailed information about a company by domain, LinkedIn URL, or any URL. Returns name, website, LinkedIn URL, logo, employee count, industry, founded year, and description. Classification: read.
• Enrich Company (Bulk) (enrich_company_bulk), Get detailed information for up to 10 companies in a single request. Each result contains either company data or an error. Classification: read.
• Get Company Paths (get_company_paths), Find introduction paths to people at a specific company. Returns up to 50 employees you can reach through your network, ranked by connection strength. Classification: read.
• List Companies (list_companies), Get your top-connected companies ranked by network strength. Returns a paginated list with connection score, label, LinkedIn URL, domain, and enrichment data. Classification: read.
• Search Companies (search_companies), Search for companies using natural language (in the "prompt" field) and/or structured filters. Returns matching companies with relevance and connection-strength scores; supports cursor-based pagination. Classification: read.
• Sort Companies (sort_companies), Rank a list of companies (up to 100 LinkedIn URLs or domains) by how well-connected you are to people there. Each result includes a score, label, LinkedIn URL, and domain. Classification: read.
• Join Group (join_group), Join a group using an invite link. Once joined, you gain access to the shared network of all group members. Classification: read.
• Leave Group (leave_group), Leave a group you are a member of. If you are the last member, the group is deleted. Admins must remove all other members before leaving. Classification: read.
• List Groups (list_groups), Get all groups (communities) you are a member of. Groups allow members to share network access with each other, expanding everyone's reach. Classification: read.
• Create or Update Group (upsert_group), Create a new group or update an existing one. To create: provide a name (id is auto-generated). To update: provide group_id (requires admin permissions). Classification: read.
• List Gmail Integrations (list_integrations), Get all your connected Gmail integrations, including rate limits, timezone, the default sending account, and whether you can add more based on your plan. Classification: read.
• Reset Integration (resync_integration), Trigger a full resync of a Google or LinkedIn integration. Clears sync cursors and re-imports all contacts/calendar data; all graph operations use MERGE so it is fully idempotent. Classification: read.
• Update Gmail Integration (update_integration), Update settings for a connected Gmail integration, adjust rate limits, timezone, status, or set as the default sending account. Provide only the fields you want to change. Classification: read.
• Add items to list (add_list_items), Add people or companies to a list. Each identifier is resolved (LinkedIn URLs, company domains, emails, or graph IDs) and added. Returns detailed results per item. Classification: read.
• Check list membership (check_list_membership), Check which lists contain the given entities. Returns a map of entity_id to the lists that contain it. Entities not in any list are omitted. Classification: read.
• Create a list (create_list), Create a new list to organize people or companies. The creator becomes the list owner. List creation may be limited based on your subscription plan. Classification: read.
• Delete a list (delete_list), Permanently delete a list and all its items. This action cannot be undone. Classification: read.
• Get a list (get_list), Get a list with all its items. Returns the list metadata plus paginated items. For people lists, items are sorted by connection strength (warmth score). Classification: read.
• List all lists (list_lists), Get all your saved lists of people or companies. Supports pagination, filtering by type, and searching by title. Classification: read.
• Remove items from list (remove_list_items), Remove items from a list by their item IDs (obtained from get_list). Returns the count of successfully removed items. Classification: read.
• Update a list (update_list), Update a list's metadata. Provide at least one of: title or description. The list type cannot be changed after creation. Classification: read.
• Enrich Person (enrich_person), Get detailed profile information (name, headline, current company, location, photo, LinkedIn URL) for a person identified by LinkedIn URL or generic URL. Classification: read.
• Enrich Person (Bulk) (enrich_person_bulk), Get detailed profile information for up to 10 people in a single request. Partial results are returned if some lookups fail, check each result for success or error status. Classification: read.
• Enrich Person Email (enrich_person_email), Find the email address for a person by LinkedIn URL or generic URL. Returns the verified email address if found, or null if unavailable. Classification: read.
• Enrich Person Email (Bulk) (enrich_person_email_bulk), Find email addresses for up to 10 people in a single request. Returns email addresses where found, with error messages for failed lookups. Classification: read.
• Get Person Paths (get_person_paths), Find introduction paths to reach a specific person through your professional network. Provide a LinkedIn URL and get back direct connections, mutual contacts, and connection strength scores (0-100). Classification: read.
• Get Person Paths (Bulk) (get_person_paths_bulk), Find introduction paths to multiple people in a single request. Provide up to 100 LinkedIn IDs (the slug after linkedin.com/in/) and get connection paths for each. Classification: read.
• List People (list_people), Get your network contacts ranked by connection strength. Returns a paginated list with enrichment data, supporting cursor-based pagination and optional connection-degree filtering. Classification: read.
• Refresh People (people_refresh), Refresh or import people data from LinkedIn URLs. In realtime mode, returns enriched person data immediately (or times out after 25 seconds and converts to async). In async mode, returns job IDs for later status checking. Classification: read.
• Search People (search_people), Search for people using natural language queries. Pass your search text in "prompt" (e.g. "engineers at Google"). Supports cursor-based pagination and structured filters. Classification: read.
• Sort People (sort_people), Rank a list of LinkedIn profile URLs by how well-connected you are to them. Returns each person sorted by connection strength (highest first), with score (0-100) and score_label. Classification: read.
• Join Team (join_team), Join a team using an invite link. Provide the invite link code (the part after /join/ in the URL). Classification: read.
• Leave Team (leave_team), Leave a team you are a member of. If you are the last member of a non-paid team, the team is deleted. Admins of paid teams cannot leave, use Cancel Plan instead. Classification: read.
• List Teams (list_teams), Get all teams you are a member of. Each team includes id, name, logo, invite_link, and an is_admin flag indicating your admin status. Classification: read.
• Create or Update Team (upsert_team), Create or update a team. The team ID is derived from the team name; repeated calls with the same name update the same team (requires admin permissions on update). Classification: read.
• Get Current User (get_current_user), Get profile information for the authenticated user, id, email, name, account creation date, sync completion status, and active flag. Useful for verifying auth and checking whether the user's network data is ready. Classification: read.
• Import Relationships (import_relationships), Import manual relationships to expand your network graph, useful for adding people you know but aren't connected to digitally. Provide email addresses or LinkedIn URLs with optional scores (0-10); higher scores indicate stronger relationships. Max 1000 per request. Classification: read.

Trigger contracts

• No trigger delivery contracts are declared.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

Authentication

Authentication method: custom

Authentication profiles

Setup

Setup

1. Add the Village connector to the workflow in the target Flows360 Studio instance.
2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
3. Provide the connection fields declared by the pinned package:

• No provider credential fields are declared by the pinned package.

1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

• This content describes @activepieces/piece-village@0.4.4; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
• Only the 40 actions and 0 triggers declared by this pinned package are represented here.
• Tenant credentials and connection values are not stored in the public connector record.
• Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
• Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Related documentation