folk

Keep your folk CRM in sync automatically. Agents create, update, and delete people and companies, manage group membership, read custom fields, and look up workspace users across 17 actions.

17 actions API key available

folk website ↗ Platform Documentation ↗ Capability data verified 2026-07-27

A new intro request arrives from the website form

Create Person captures the contact with email, role, and company, and folk creates the unknown company automatically

Add Person to Group files them under the prospects segment without disturbing their other memberships

List Group Custom Fields confirms the segment's field names before the agent writes source and status values

Update Person fills the custom fields, carrying the complete email and group arrays so nothing gets replaced away

The relationship owner, resolved with List Users, receives a digest of the week's new people with context

The owner decides who gets a personal note and who enters the standard sequence

What This Integration Enables

folk is built for teams whose asset is the network, not the pipeline: agencies, investors, partnership teams, founders who sell through relationships. In that model a contact is not a lead to be advanced; it is a relationship to be kept warm, and the groups that organize people are the real working surface. The failure mode is equally distinctive: relationship businesses generate touchpoints everywhere, and the gardening required to file them all is precisely the work that loses to the next meeting. FlowRunner agents do the gardening. They create and update people and companies, manage group membership surgically, discover a group's custom fields before mapping data into them, and resolve workspace users so every new relationship reaches its owner. - Capture people and companies from any connected system, with unknown company names created automatically - Add and remove group membership without touching a person's other groups - Discover custom fields per group and entity type before writing values into them - Resolve owners and assignees from the workspace user list One catalog detail shapes everything this connector does: on updates, array fields replace existing values rather than appending. FlowRunner workflows are built around that rule, reading the record first and writing back complete arrays, with a [human-in-the-loop](/concepts/human-in-the-loop) check wherever a bulk write could silently shrink a record.

Without FlowRunner

Networking that evaporates Intros, dinners, and calls produce contacts that never make it into folk

Segments gone stale Groups reflect who mattered last quarter, because curating them is midnight work

The update that erases One careless sync replaces a person's email array or wipes their group memberships

With FlowRunner

Every touchpoint lands Signups, bookings, and orders become people, filed into the right groups as they arrive

Segments as living lists Membership follows behavior: added on signal, removed on silence, other groups untouched

Writes that respect the record Agents read before writing and carry full arrays, so updates preserve every email, phone, and group

Use Case Scenarios

The network that files itself

A new customer appears in [Shopify](/integrations/shopify), an invitee books through [Calendly](/integrations/calendly), a form submission lands from the site. Each one becomes a Create Person call with the company associated by name, then Add Person to Group files them into the right segment: customers, prospects, event contacts. Because Add Person to Group appends rather than replaces, someone who is already a portfolio founder and a conference speaker simply gains a third membership. The network grows without anyone doing data entry.

The weekly outreach digest, owner's cut

Every Friday, an agent pulls the dormant-relationships group with List People, hydrates each contact with Get Person, and exports the list to [Google Sheets](/integrations/google-sheets) with last-known context: job title, companies, groups. The digest goes to the relationship owner, who marks who gets a personal note. Only the marked rows flow onward to [Gmail](/integrations/gmail-service) drafts. The agent decides who has gone quiet; the human decides who hears from them, because in a relationship business the outreach is the product.

Enrichment that cannot shrink a record

An enrichment pass pairs folk with [Dropcontact](/integrations/dropcontact). For each person in the prospects group, the agent fetches the current record with Get Person, merges newly found emails and URLs into the existing arrays, and calls Update Person with the union, never the fragment. List Group Custom Fields runs first so enriched attributes land in the fields the team actually uses. Records only ever gain information.

Human-in-Loop Highlight

The dangerous write in folk is not only Delete Person, though that is permanent and gated. It is Update Person's replace semantics: an update that supplies a partial email array or a partial groups array silently discards whatever it omitted, and there is no error, no warning, just a thinner record. So before any bulk update runs, the agent computes the diff and shows it: "This sync will touch 41 people. On 3 of them, the incoming data would drop an existing email address; on 1, it would remove two group memberships. Apply to all, apply to the 37 clean ones, or hold the 4?" A person answers before anything is written. Deletions get the same treatment with a harder edge: Delete Person and Delete Company cannot be undone, so the agent presents the full record it is about to erase, and a named human says the word.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via email

Human decides

Agent resumes with decision

Agent Capabilities

17 actions

People

List People Retrieves a cursor-paginated list of people in the workspace, optionally filtered to a group. Each person includes name, emails, phones, URLs, job title, associated companies, and group memberships.
Get Person Retrieves a single person by ID with full details, including addresses, description, birthday, group memberships, and custom field values. The read that runs before every careful write.
Create Person Creates a new person with name and optional contact details. Emails, phones, URLs, and addresses are arrays with the first entry treated as primary. Assign groups by ID and associate companies by ID or name; unknown company names are created automatically.
Update Person Updates a person by ID. Only provided fields change, but array fields replace existing values rather than appending, so FlowRunner workflows send the complete intended arrays.
Delete Person Permanently deletes a person from the workspace. Cannot be undone, and never runs in a FlowRunner workflow without a named approver.
Add Person to Group Adds a person to a group by reading their current memberships and appending the target, leaving every other membership intact. Already-members are left unchanged.
Remove Person from Group Removes a person from one group while preserving their other memberships.

Companies

List Companies Retrieves a cursor-paginated list of companies, optionally filtered to a group, with name, emails, phones, URLs, description, and group memberships.
Get Company Retrieves a single company by ID with full details and custom field values.
Create Company Creates a new company with a name and optional contact details, assignable to groups by ID.
Update Company Updates a company by ID. The same array-replace semantics apply as for people, and the same read-first discipline.
Delete Company Permanently deletes a company from the workspace. Cannot be undone.

Groups

List Groups Retrieves the workspace's groups, folk's equivalent of lists and segments, cursor-paginated.
List Group Custom Fields Retrieves the custom fields defined for a group for people or companies. The discovery step before mapping data into a group's fields.

Users

List Users Retrieves the workspace's team members with names and email addresses. Used to resolve owners and assignees.
Get User Retrieves a single workspace user by ID.
Get Current User Retrieves the user tied to the API key in use. Used to confirm the connected account and workspace.

Frequently Asked Questions

What can FlowRunner do with folk?

FlowRunner agents can run List People, Get Person, and Create Person in folk, plus 14 more actions.

Does connecting folk to FlowRunner require OAuth?

No. folk connects to FlowRunner with an API key, no OAuth flow required.

Can folk trigger a FlowRunner workflow automatically?

folk doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.

Start building with folk

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us