Skip to main content

folk API

Start building with folk API

folk API unlocks the power to build integrations and automations on top of your CRM data. Whether you want to sync contacts from other tools, trigger actions, or automate workflows, the API gives you full programmatic access to your workspace. It’s the foundation for creating custom workflows and seamlessly connecting folk with the rest of your stack.

What is an API?

An API (Application Programming Interface) is a set of rules that lets different software systems communicate with each other. It defines how one application can request data or actions from another — like a structured messenger between programs. APIs make it possible to build on top of existing tools without needing to access or understand their entire internal code.

Technical Overview

folk API exposes a REST API that is organized around predictable resource-oriented URLs, accepts and returns JSON-encoded payloads, and uses standard HTTP response codes, authentication, and verbs.

All requests are served from the base URL https://api.folk.app and must be made over HTTPS. By default, requests use the latest API version; you can pin a specific version with the X-API-Version header.

Authentication

Every request must include an API key as a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

You can generate a key from your workspace under Settings > API. Treat this key as a secret — anyone with it has programmatic access to your workspace data.

Requests without a valid key return a 401 Unauthorized.

Note that admins can see all the API keys created in the workspace (in Settings > API).

What you can do with it

The API covers the core objects in your CRM, so you can build integrations around:

  • People

  • Companies

  • Deals

  • Custom objects

  • Groups

  • Notes

  • Tasks

  • Interactions

  • Webhooks

API documentation

You can access the API doc here: https://developer.folk.app. If you have any questions or feedback, you can email us at support@folk.app.

Did this answer your question?