folk - Veryfront

At a glance

Availability: Experimental (how to enable).
Authentication: API key.
Connection: The key comes from FOLK_API_KEY.
Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

Variable	Required	Description
`FOLK_API_KEY`	Yes	folk API key (sent as Authorization: Bearer), generated in workspace settings → API Docs.

Setup

Create a folk workspace: Sign up at https://www.folk.app/ - the free plan is enough to test the API.
Generate an API key: In folk, open workspace settings → API (https://app.folk.app/apps/contacts/network/settings/api-keys) and generate a new API key (keys start with ‘FOLK’).
Set the environment variable: Add FOLK_API_KEY to your .env.
Verify access: Run the List Groups tool, then List People.

Provider notes

The API key is sent as Authorization: Bearer <key>
List endpoints return { data: { items, pagination } } and paginate with limit/cursor; pass pagination.nextLink’s cursor to continue
Rate limit headers (X-RateLimit-*) are returned on every response

Provider API reference.

Tools

Tool	Access	Description
List People `folk__list_people`	Read	List people in the folk workspace with optional filters
Get Person `folk__get_person`	Read	Get details of a person in folk
Create Person `folk__create_person`	Write	Create a new person in folk
Update Person `folk__update_person`	Write	Update fields on an existing person in folk
List Companies `folk__list_companies`	Read	List companies in the folk workspace
Create Company `folk__create_company`	Write	Create a new company in folk
List Groups `folk__list_groups`	Read	List groups (pipelines/segments) in the folk workspace

Verify the connection

Call a read tool such as folk__list_people with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.