folk

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
FOLK_API_KEYYesfolk API key (sent as Authorization: Bearer), generated in workspace settings → API Docs.

Setup

  1. Create a folk workspace: Sign up at https://www.folk.app/ - the free plan is enough to test the API.
  2. 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').
  3. Set the environment variable: Add FOLK_API_KEY to your .env.
  4. 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

ToolAccessDescription
List People<br /><code className="reference-identifier">folk__list_people</code>ReadList people
Get Person<br /><code className="reference-identifier">folk__get_person</code>ReadGet person
Create Person<br /><code className="reference-identifier">folk__create_person</code>WriteCreate person
Update Person<br /><code className="reference-identifier">folk__update_person</code>WriteUpdate person
List Companies<br /><code className="reference-identifier">folk__list_companies</code>ReadList companies
Create Company<br /><code className="reference-identifier">folk__create_company</code>WriteCreate company
List Groups<br /><code className="reference-identifier">folk__list_groups</code>ReadList groups

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.