Folk

People-first CRM API for managing contacts, companies, deals, and notes across customizable pipelines. Best for agents that need to sync contacts, log meeting notes, or manage deal flow in a lightweight CRM. Unlike HubSpot or Salesforce, Folk is designed for small teams with a flat data model and one-click enrichment. 12 example endpoints available through Lava’s AI Gateway. See the Folk API docs for full documentation.

This provider requires your own credentials — connect your API key or OAuth account before use.

This is a catch-all provider — any valid URL under https://api.folk.app is supported. Folk CRM API. Base: https://api.folk.app, all paths under /v1/. Auth: Bearer token (generate at app.folk.app settings > API keys). Rate limit: 600 req/min. Resources: /v1/people, /v1/companies, /v1/notes, /v1/groups, /v1/users, /v1/webhooks, /v1/reminders, /v1/interactions. Deals are group sub-resources: POST /v1/groups// — get groupId and objectType from GET /v1/groups and GET /v1/groups/custom-fields first. Cursor pagination: pass cursor + limit params, follow pagination.nextLink in response. Requires Folk Premium plan or higher. See https://developer.folk.app/api-reference/overview for full reference. The endpoints below are curated examples.

Endpoints

Get the current authenticated user. Use as an auth check after connecting a Folk API key.

GET https://api.folk.app/v1/users/me — Free

SDK
cURL

const data = await lava.gateway('https://api.folk.app/v1/users/me', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.folk.app%2Fv1%2Fusers%2Fme" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List contacts with cursor-based pagination. Supports cursor and limit query params.

GET https://api.folk.app/v1/people?limit=50 — Free

SDK
cURL

const data = await lava.gateway('https://api.folk.app/v1/people?limit=50', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.folk.app%2Fv1%2Fpeople%3Flimit%3D50" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create a new contact. Supports firstName, lastName, emails, phones, jobTitle, companies, and custom fields.

POST https://api.folk.app/v1/people — Free

SDK
cURL

const data = await lava.gateway('https://api.folk.app/v1/people', {
  body: {
"firstName": "Jane",
"lastName": "Smith",
"emails": [
  "jane@example.com"
],
"jobTitle": "CEO"
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.folk.app%2Fv1%2Fpeople" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"firstName":"Jane","lastName":"Smith","emails":["jane@example.com"],"jobTitle":"CEO"}'

Update an existing contact by ID. Send only the fields to change.

PATCH https://api.folk.app/v1/people/per_55175e81-9a52-4ac3-930e-82792c23499b — Free

SDK
cURL

const data = await lava.gateway('https://api.folk.app/v1/people/per_55175e81-9a52-4ac3-930e-82792c23499b', { method: 'PATCH', body: {"jobTitle":"CTO","phones":["+1234567890"]} });

curl -X PATCH "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.folk.app%2Fv1%2Fpeople%2Fper_55175e81-9a52-4ac3-930e-82792c23499b" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jobTitle":"CTO","phones":["+1234567890"]}'

Delete a contact by ID. This action is irreversible and removes all associated data including custom fields, notes, and relationships.

DELETE https://api.folk.app/v1/people/per_55175e81-9a52-4ac3-930e-82792c23499b — Free

SDK
cURL

const data = await lava.gateway('https://api.folk.app/v1/people/per_55175e81-9a52-4ac3-930e-82792c23499b', { method: 'DELETE' });

curl -X DELETE "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.folk.app%2Fv1%2Fpeople%2Fper_55175e81-9a52-4ac3-930e-82792c23499b" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json"

List companies with cursor-based pagination.

GET https://api.folk.app/v1/companies?limit=50 — Free

SDK
cURL

const data = await lava.gateway('https://api.folk.app/v1/companies?limit=50', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.folk.app%2Fv1%2Fcompanies%3Flimit%3D50" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create a new company. Supports name, description, industry, emails, urls, and custom fields.

POST https://api.folk.app/v1/companies — Free

SDK
cURL

const data = await lava.gateway('https://api.folk.app/v1/companies', {
  body: {
"name": "Acme Corp",
"industry": "Technology",
"urls": [
  "https://acme.com"
]
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.folk.app%2Fv1%2Fcompanies" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Corp","industry":"Technology","urls":["https://acme.com"]}'

Create a note attached to a person or company. Content supports markdown.

POST https://api.folk.app/v1/notes — Free

SDK
cURL

const data = await lava.gateway('https://api.folk.app/v1/notes', {
  body: {
"entity": {
  "id": "per_55175e81-9a52-4ac3-930e-82792c23499b"
},
"visibility": "public",
"content": "Follow-up meeting scheduled for next week."
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.folk.app%2Fv1%2Fnotes" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity":{"id":"per_55175e81-9a52-4ac3-930e-82792c23499b"},"visibility":"public","content":"Follow-up meeting scheduled for next week."}'

List all groups (segments/lists) in the workspace. Groups organize contacts into pipelines and lists.

GET https://api.folk.app/v1/groups — Free

SDK
cURL

const data = await lava.gateway('https://api.folk.app/v1/groups', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.folk.app%2Fv1%2Fgroups" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List custom field definitions. Use for schema discovery before writing records with custom fields.

GET https://api.folk.app/v1/groups/custom-fields — Free

SDK
cURL

const data = await lava.gateway('https://api.folk.app/v1/groups/custom-fields', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.folk.app%2Fv1%2Fgroups%2Fcustom-fields" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Record an interaction (call, meeting, email, coffee, etc.) against a person or company. Append-only log for agent attribution.

POST https://api.folk.app/v1/interactions — Free

SDK
cURL

const data = await lava.gateway('https://api.folk.app/v1/interactions', {
  body: {
"entity": {
  "id": "per_55175e81-9a52-4ac3-930e-82792c23499b"
},
"dateTime": "2026-04-15T14:00:00.000Z",
"title": "Intro call with Jane Smith",
"content": "Discussed partnership opportunity.",
"type": "call"
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.folk.app%2Fv1%2Finteractions" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity":{"id":"per_55175e81-9a52-4ac3-930e-82792c23499b"},"dateTime":"2026-04-15T14:00:00.000Z","title":"Intro call with Jane Smith","content":"Discussed partnership opportunity.","type":"call"}'

Register a webhook to receive notifications when contacts, companies, or other records change in Folk.

POST https://api.folk.app/v1/webhooks — Free

SDK
cURL

const data = await lava.gateway('https://api.folk.app/v1/webhooks', {
  body: {
"name": "Contact sync",
"targetUrl": "https://example.com/folk-webhook",
"subscribedEvents": [
  {
    "eventType": "person.created"
  }
]
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.folk.app%2Fv1%2Fwebhooks" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Contact sync","targetUrl":"https://example.com/folk-webhook","subscribedEvents":[{"eventType":"person.created"}]}'

Get Started

AI Gateway

AI Spend

Monetize

Integration

SDK

Cookbook

Comparisons

Endpoints

Get the current authenticated user. Use as an auth check after connecting a Folk API key.

Create a new contact. Supports firstName, lastName, emails, phones, jobTitle, companies, and custom fields.

Update an existing contact by ID. Send only the fields to change.

Delete a contact by ID. This action is irreversible and removes all associated data including custom fields, notes, and relationships.

Create a new company. Supports name, description, industry, emails, urls, and custom fields.

Create a note attached to a person or company. Content supports markdown.

List all groups (segments/lists) in the workspace. Groups organize contacts into pipelines and lists.

List custom field definitions. Use for schema discovery before writing records with custom fields.

Record an interaction (call, meeting, email, coffee, etc.) against a person or company. Append-only log for agent attribution.

Register a webhook to receive notifications when contacts, companies, or other records change in Folk.

Next Steps

All Providers

Forward Proxy

Get Started

AI Gateway

AI Spend

Monetize

Integration

SDK

Cookbook

Comparisons

​Endpoints

​Get the current authenticated user. Use as an auth check after connecting a Folk API key.

​List contacts with cursor-based pagination. Supports cursor and limit query params.

​Create a new contact. Supports firstName, lastName, emails, phones, jobTitle, companies, and custom fields.

​Update an existing contact by ID. Send only the fields to change.

​Delete a contact by ID. This action is irreversible and removes all associated data including custom fields, notes, and relationships.

​List companies with cursor-based pagination.

​Create a new company. Supports name, description, industry, emails, urls, and custom fields.

​Create a note attached to a person or company. Content supports markdown.

​List all groups (segments/lists) in the workspace. Groups organize contacts into pipelines and lists.

​List custom field definitions. Use for schema discovery before writing records with custom fields.

​Record an interaction (call, meeting, email, coffee, etc.) against a person or company. Append-only log for agent attribution.

​Register a webhook to receive notifications when contacts, companies, or other records change in Folk.

​Next Steps

All Providers

Forward Proxy

Endpoints

Get the current authenticated user. Use as an auth check after connecting a Folk API key.

List contacts with cursor-based pagination. Supports cursor and limit query params.

Create a new contact. Supports firstName, lastName, emails, phones, jobTitle, companies, and custom fields.

Update an existing contact by ID. Send only the fields to change.

Delete a contact by ID. This action is irreversible and removes all associated data including custom fields, notes, and relationships.

List companies with cursor-based pagination.

Create a new company. Supports name, description, industry, emails, urls, and custom fields.

Create a note attached to a person or company. Content supports markdown.

List all groups (segments/lists) in the workspace. Groups organize contacts into pipelines and lists.

List custom field definitions. Use for schema discovery before writing records with custom fields.

Record an interaction (call, meeting, email, coffee, etc.) against a person or company. Append-only log for agent attribution.

Register a webhook to receive notifications when contacts, companies, or other records change in Folk.

Next Steps