At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key comes from
FOLK_API_KEY. - Docs: https://developer.folk.app/api-reference/authentication
Credentials
Set these per environment. See Connect an integration.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.
- 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
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.