folk
Create and manage people, companies, and groups in folk CRM.
Connectors
Choose the connector that matches your authentication method. The options below use the names shown in StackAI.
folk
API Key
folk
Connect to folk to create and manage people, companies, and groups.
Set up in folk
Prepare the folk account or service that the workflow will access. Grant access to the required resources and operations.
API Key: Create an API key in folk under Settings, API, then paste it here.
Set up in StackAI
Open Settings → Connections, add a connection, and select folk.
Enter the credentials and connection details in the fields below.
Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.
Connection fields
Verify the connection
Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.
If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.
Use an action
Add the required folk action to the workflow.
Select a connection when the action requests one.
Complete the required fields. Use the reference picker when a value comes from another workflow step.
Run the workflow and inspect the action’s output. Check the result before using it in a later step.
Actions
Create Person
Create a person in folk after acknowledging that an exact first-name, last-name, and email, phone, or personal social-profile match may trigger a background merge that overwrites existing data.
Inputs
First name
string
Yes
The person's first name.
Last name
string
Yes
The person's last name.
Acknowledge automatic merge
boolean
Yes
Confirm that folk may background-merge an exact first-name, last-name, and email, phone, or personal social-profile match into an existing record and overwrite existing data. Default: false.
Primary email
string
No
The person's primary email address; adding it can trigger automatic duplicate merging.
Primary phone
string
No
The person's primary phone number; adding it can trigger automatic duplicate merging.
Personal social profile URL
string
No
A personal LinkedIn, Instagram, Facebook, or X profile URL; adding it can trigger automatic duplicate merging.
Job title
string
No
The person's role or job title.
Company name
string
No
The person's primary company; folk creates the company if it does not exist.
Group
select (string)
No
Optionally place the new person in a folk group. Options load from the selected connection.
Description
textarea
No
Notes or context about the person.
Outputs
Person ID
string
The folk person identifier returned immediately after creation.
Full name
string
The person's returned full name.
Merge warning
string
A reminder that folk may still merge the record in the background.
Create company
Create or return a company in folk using its workspace-unique name.
Inputs
Company name
string
Yes
The company's workspace-unique name.
Description
textarea
No
A short description of the company.
Industry
string
No
The company's industry.
Foundation year
integer
No
The four-digit year the company was founded.
Employee range
select (string)
No
The approximate number of employees. Available values: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10000+.
Primary website
string
No
The company's primary website URL.
Group
select (string)
No
Optionally place the company in a folk group. Options load from the selected connection.
Outputs
Company ID
string
The created or existing folk company identifier.
Company name
string
The returned company name.
List people
List folk people with optional name, email, company, or group filters.
Inputs
Full name
string
No
Only return people matching this full name.
string
No
Only return people matching this email address.
Company name
string
No
Only return people associated with this company name.
Group
select (string)
No
Only return people in this folk group. Options load from the selected connection.
Filter matching
select (string)
No
Require all filters or allow any filter to match. Available values: Match all filters, Match any filter. Default: and.
Maximum people
integer
No
The maximum number of people to return in this call. Default: 100.
Cursor
string
No
Continue from a cursor returned by an earlier call.
Outputs
People
object_array
The typed list of matching folk people.
Next cursor
string
The opaque cursor for the next page, when more people remain.
List groups
List folk groups so people and companies can be assigned by group ID.
Inputs
Maximum groups
integer
No
The maximum number of groups to return. Default: 100.
Cursor
string
No
Continue from a cursor returned by an earlier call.
Outputs
Groups
object_array
The typed list of folk groups.
Next cursor
string
The opaque cursor for the next page, when more groups remain.
Add person to group
Add a person to a folk group while preserving current memberships. A concurrent group change can race because folk replaces the complete group list.
Inputs
Person
select (string)
Yes
The person to add to the group. Options load from the selected connection.
Group
select (string)
Yes
The group to add without removing other memberships. Options load from the selected connection.
Outputs
Person ID
string
The updated folk person identifier.
Group IDs
string_array
All group memberships preserved on the person.
Already a member
boolean
Whether the person already belonged to the requested group.
Update person
Update a person's scalar profile details in folk without replacing contact lists or group memberships.
Inputs
Person
select (string)
Yes
The person to update. Options load from the selected connection.
First name
string
No
A replacement first name; leave blank to keep it unchanged.
Last name
string
No
A replacement last name; leave blank to keep it unchanged.
Job title
string
No
A replacement job title; leave blank to keep it unchanged.
Description
textarea
No
Replacement notes or context; leave blank to keep them unchanged.
Birthday
date
No
A replacement birthday in YYYY-MM-DD format.
Gender
select (string)
No
A replacement gender value supported by folk. Available values: Male, Female, Unknown, Other.
Outputs
Person ID
string
The updated folk person identifier.
Full name
string
The person's updated full name.
Important behavior
Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.
The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.
Last updated
Was this helpful?

