Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.

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.
  • 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: https://developer.folk.app/

Tools

Example prompts

  • List people in my folk workspace and find the one matching a given name or email.
  • Create a new person in folk with their name, email, and job title.