Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

Folk

Folk is a CRM for building relationships at scale. Manage your contacts, companies, and relationships in one place.

CategorySales And Crm
Authenticationcustom
Version0.1.7
Published scopes0 published scopes
Last updatedSeptember 19, 2026

Overview

Connect Folk with Flows360

Folk is a CRM for building relationships at scale. Manage your contacts, companies, and relationships in one place.

Use the Folk 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 8 actions and 8 triggers.

Available actions

  • Create Company
  • Update Company
  • Create Person
  • Update Person
  • Find Company
  • Get Company
  • List People
  • Get Person

Available triggers

  • Company Added
  • Company Removed
  • Company Updated
  • Company Groups Updated
  • Person Added
  • Person Removed
  • Plus 2 additional declared triggers.

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: Folk
  • Package: @activepieces/piece-folk@0.1.7
  • Exact artifact digest: sha256:df0c650f308aa9f5b7d1f0fe067793e1e1bd8c02d6fa168ad0e0145a259bb787
  • 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

  • Create Company (createCompany), Create a new company in your Folk workspace. You can add emails, links, phone numbers, and assign it to a group. Classification: read.
  • Update Company (updateCompany), Update an existing company in your Folk workspace. Select the company from the dropdown to update its details. Classification: read.
  • Create Person (createPerson), Create a new person in your Folk workspace. You can link them to a company, add contact details, and assign to a group. Classification: read.
  • Update Person (updatePerson), Update an existing person in your Folk workspace with new information. Classification: read.
  • Find Company (findCompany), Search for companies in your Folk workspace by name or email address. Classification: read.
  • Get Company (getCompany), Retrieve detailed information about a company from your Folk workspace. Classification: read.
  • List People (findPerson), Retrieve a paginated list of people in your Folk workspace with optional filtering. Classification: read.
  • Get Person (getPerson), Retrieve detailed information about a person from your Folk workspace. Classification: read.

Trigger contracts

  • Company Added, webhook.
  • Company Removed, webhook.
  • Company Updated, webhook.
  • Company Groups Updated, webhook.
  • Person Added, webhook.
  • Person Removed, webhook.
  • Person Updated, webhook.
  • Person Groups Updated, webhook.

Verification

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

Capability summary

Authenticationcustom
Supported objects16
Supported actions8
Triggers8

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • API Key Required · protected credential

Supported objects

ObjectReadWriteNotes
Create Company Yes No Create a new company in your Folk workspace. You can add emails, links, phone numbers, and assign it to a group.
Update Company Yes No Update an existing company in your Folk workspace. Select the company from the dropdown to update its details.
Create Person Yes No Create a new person in your Folk workspace. You can link them to a company, add contact details, and assign to a group.
Update Person Yes No Update an existing person in your Folk workspace with new information.
Find Company Yes No Search for companies in your Folk workspace by name or email address.
Get Company Yes No Retrieve detailed information about a company from your Folk workspace.
List People Yes No Retrieve a paginated list of people in your Folk workspace with optional filtering.
Get Person Yes No Retrieve detailed information about a person from your Folk workspace.
Company Added Yes No webhook trigger declared by the pinned package.
Company Removed Yes No webhook trigger declared by the pinned package.
Company Updated Yes No webhook trigger declared by the pinned package.
Company Groups Updated Yes No webhook trigger declared by the pinned package.
Person Added Yes No webhook trigger declared by the pinned package.
Person Removed Yes No webhook trigger declared by the pinned package.
Person Updated Yes No webhook trigger declared by the pinned package.
Person Groups Updated Yes No webhook trigger declared by the pinned package.

Supported actions

Create Company · Read

Create a new company in your Folk workspace. You can add emails, links, phone numbers, and assign it to a group.

create_company · Risk: low · Retry: safe

Inputs

  • name · string · Required, The name of the company
  • description · string · Optional, A short description of the company
  • industry · string · Optional, The industry the company operates in
  • addresses · array · Optional, Physical addresses for the company. The first address is primary.
  • emails · array · Optional, Email addresses for the company. The first email is primary.
  • phones · array · Optional, Phone numbers for the company. The first phone is primary.
  • urls · array · Optional, Website URLs for the company. The first URL is primary.
  • groupId · string · Optional, Enter a Folk group ID (e.g., grp_abc123). Groups help you organize your contacts.
Update Company · Read

Update an existing company in your Folk workspace. Select the company from the dropdown to update its details.

update_company · Risk: low · Retry: safe

Inputs

  • companyId · string · Required, Select a company from your Folk workspace.
  • name · string · Optional, The name of the company
  • description · string · Optional, A short description of the company
  • industry · string · Optional, The industry the company operates in
  • addresses · array · Optional, Physical addresses for the company. The first address is primary.
  • emails · array · Optional, Email addresses for the company. The first email is primary.
  • phones · array · Optional, Phone numbers for the company. The first phone is primary.
  • urls · array · Optional, Website URLs for the company. The first URL is primary.
  • groupId · string · Optional, Enter a Folk group ID (e.g., grp_abc123). Groups help you organize your contacts.
Create Person · Read

Create a new person in your Folk workspace. You can link them to a company, add contact details, and assign to a group.

create_person · Risk: low · Retry: safe

Inputs

  • firstName · string · Optional, The first name of the person
  • lastName · string · Optional, The last name of the person
  • fullName · string · Optional, The full name of the person (alternative to first/last)
  • description · string · Optional, A short description of the person
  • birthday · string · Optional, The birthday in YYYY-MM-DD format
  • jobTitle · string · Optional, The job title of the person
  • companyNames · array · Optional, The names of companies to associate with the person. The first company will be primary.
  • companyIds · array · Optional, Select companies to associate with the person.
  • addresses · array · Optional, Physical addresses for the person. The first address is primary.
  • emails · array · Optional, Email addresses for the person. The first email is primary.
  • phones · array · Optional, Phone numbers for the person. The first phone is primary.
  • urls · array · Optional, Website URLs for the person. The first URL is primary.
  • groupId · string · Optional, Enter a Folk group ID (e.g., grp_abc123). Groups help you organize your contacts.
Update Person · Read

Update an existing person in your Folk workspace with new information.

update_person · Risk: low · Retry: safe

Inputs

  • personId · string · Required, Select a person from your Folk workspace.
  • firstName · string · Optional, The first name of the person
  • lastName · string · Optional, The last name of the person
  • fullName · string · Optional, The full name of the person (alternative to first/last)
  • description · string · Optional, A short description of the person
  • birthday · string · Optional, The birthday in YYYY-MM-DD format
  • jobTitle · string · Optional, The job title of the person
  • companyIds · array · Optional, Select companies to associate with the person.
  • companyNames · array · Optional, Company names to create or associate with. Companies will be created if they don't exist.
  • addresses · array · Optional, Physical addresses for the person. The first address is primary.
  • emails · array · Optional, Email addresses for the person. The first email is primary.
  • phones · array · Optional, Phone numbers for the person. The first phone is primary.
  • urls · array · Optional, Website URLs for the person. The first URL is primary.
  • groupId · string · Optional, Enter a Folk group ID (e.g., grp_abc123). Groups help you organize your contacts.
Find Company · Read

Search for companies in your Folk workspace by name or email address.

find_company · Risk: low · Retry: safe

Inputs

  • query · string · Required, Enter company name or email to search for
Get Company · Read

Retrieve detailed information about a company from your Folk workspace.

get_company · Risk: low · Retry: safe

Inputs

  • companyId · string · Required, Select a company from your Folk workspace.
List People · Read

Retrieve a paginated list of people in your Folk workspace with optional filtering.

find_person · Risk: low · Retry: safe

Inputs

  • limit · number · Optional, The number of items to return (1-100)
  • cursor · string · Optional, A cursor for pagination. Use the nextLink value from a previous response.
  • combinator · string · Optional, The logical operator to combine multiple filters
  • nameFilter · string · Optional, Filter by person name (contains)
  • emailFilter · string · Optional, Filter by email address (contains)
Get Person · Read

Retrieve detailed information about a person from your Folk workspace.

get_person · Risk: low · Retry: safe

Inputs

  • personId · string · Required, Select a person from your Folk workspace.

Triggers

Company Added · Webhook

Fires when a new company is added to your Folk workspace.

Inputs

  • groupId · string
Company Removed · Webhook

Fires when a company is removed from your Folk workspace.

Inputs

  • groupId · string
Company Updated · Webhook

Fires when a company is updated in your Folk workspace.

Inputs

  • groupId · string
Company Groups Updated · Webhook

Fires when a company's group assignments are updated in your Folk workspace.

Person Added · Webhook

Fires when a new person is added to your Folk workspace.

Inputs

  • groupId · string
Person Removed · Webhook

Fires when a person is removed from your Folk workspace.

Inputs

  • groupId · string
Person Updated · Webhook

Fires when a person is updated in your Folk workspace.

Inputs

  • groupId · string
Person Groups Updated · Webhook

Fires when a person's group assignments are updated in your Folk workspace.

Setup

Setup

  1. Add the Folk 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-folk@0.1.7; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 8 actions and 8 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

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required Folk connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-folk@0.1.7 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.

github.com