folk

Delete an existing company in the workspace. Companies are folk's organisation records, linked to people and to deals.

Removes a member from a group. Group members are WORKSPACE USERS with access to a group, not the contacts inside it. A public group is accessible to every workspace member.

Delete an existing deal in the workspace. A group can hold any object type you define -- `Deals` is the default, and `Projects`, `Applications` and so on are custom objects. They all share one set of endpoints under /v1/groups/{groupId}/{objectType}, and `objectType` is the type's name exactly as the folk app spells it (the match is CASE-SENSITIVE). List the group's custom fields for `person` to find the available names.

Delete an existing logged interaction. Imported interactions cannot be deleted. This endpoint is currently in open beta. The API surface may change as we iterate based on feedback. Interactions are the logged history with a contact -- meetings, calls, emails. folk marks the past/upcoming/get/update/delete family OPEN BETA in its own schema, so the surface may change.

Delete an existing note in the workspace. Notes are free-text entries attached to a person, company or object.

Delete an existing person in the workspace. People are folk's contact records. A person may belong to several groups and several companies at once.

Delete an existing reminder in the workspace. This endpoint is deprecated since August 13, 2026 and will be removed on February 13, 2027. Please use the Delete a task endpoint instead. DEPRECATED by folk since 13 August 2026 and scheduled for REMOVAL on 13 February 2027; the live response carries a `deprecations` array saying so. Use the Tasks tools instead for anything new -- this one still answers 200 today and will stop.

Delete an existing task in the workspace. Tasks are folk's to-dos, each attached to a person, company or object, with a due date, optional assignees and a done/to-do state.

Delete an existing webhook in the workspace. Webhooks deliver workspace events to a URL you own. The per-webhook signing secret folk returns AT CREATION is shown once and is NOT a folk API credential: it verifies inbound deliveries to your handler (Standard Webhooks, HMAC-SHA256) and is never used to call folk.

Retrieve a list of companies in the workspace. Companies are folk's organisation records, linked to people and to deals. `filter` is a JSON OBJECT SUPPLIED AS TEXT -- for example `{"fullName": {"like": "Horace"}}` or `{"groups": {"in": {"id": "grp_..."}}}`. Agentic Fabriq expands it into the bracketed form folk actually accepts (`filter[fullName][like]=Horace`); folk refuses the object sent any other way with 422. Each key is a filterable attribute and each inner key an operator (`eq`, `not_eq`, `like`, `not_like`, `gt`, `lt`, `in`, `all`, `empty`, `not_empty`); an attribute folk does not recognise is refused with 422 `unrecognized_keys` naming it. `combinator` decides whether several filters are ANDed or ORed.

Retrieve an existing company in the workspace. Companies are folk's organisation records, linked to people and to deals.

Returns a list of workspace groups. Groups are folk's collections of contacts; a workspace is organised into them and most other resources are addressed through one.

Returns a list of group custom fields for an entity type. Group custom fields define the extra columns a group's people, companies and custom objects carry. Listing them for the `person` entity type is also how you discover a group's object types: every field of type `objectField` names one, and its `name` is what goes in `objectType`.

Returns a detailed group custom field for an entity type. Group custom fields define the extra columns a group's people, companies and custom objects carry. Listing them for the `person` entity type is also how you discover a group's object types: every field of type `objectField` names one, and its `name` is what goes in `objectType`.

Returns a list of the group members. For a public group, all workspace members are members of the group. Group members are WORKSPACE USERS with access to a group, not the contacts inside it. A public group is accessible to every workspace member.

Retrieve a list of deals in the workspace. A group can hold any object type you define -- `Deals` is the default, and `Projects`, `Applications` and so on are custom objects. They all share one set of endpoints under /v1/groups/{groupId}/{objectType}, and `objectType` is the type's name exactly as the folk app spells it (the match is CASE-SENSITIVE). List the group's custom fields for `person` to find the available names. `filter` is a JSON OBJECT SUPPLIED AS TEXT -- for example `{"fullName": {"like": "Horace"}}` or `{"groups": {"in": {"id": "grp_..."}}}`. Agentic Fabriq expands it into the bracketed form folk actually accepts (`filter[fullName][like]=Horace`); folk refuses the object sent any other way with 422. Each key is a filterable attribute and each inner key an operator (`eq`, `not_eq`, `like`, `not_like`, `gt`, `lt`, `in`, `all`, `empty`, `not_empty`); an attribute folk does not recognise is refused with 422 `unrecognized_keys` naming it. `combinator` decides whether several filters are ANDed or ORed.

Retrieve an existing deal in the workspace. A group can hold any object type you define -- `Deals` is the default, and `Projects`, `Applications` and so on are custom objects. They all share one set of endpoints under /v1/groups/{groupId}/{objectType}, and `objectType` is the type's name exactly as the folk app spells it (the match is CASE-SENSITIVE). List the group's custom fields for `person` to find the available names.

Retrieves a single interaction. Full email or calendar body is included when privacy rules allow it. This endpoint is currently in open beta. The API surface may change as we iterate based on feedback. Interactions are the logged history with a contact -- meetings, calls, emails. folk marks the past/upcoming/get/update/delete family OPEN BETA in its own schema, so the surface may change.

Retrieves paginated past interactions linked to a person, company, or object. This endpoint is currently in open beta. The API surface may change as we iterate based on feedback. Interactions are the logged history with a contact -- meetings, calls, emails. folk marks the past/upcoming/get/update/delete family OPEN BETA in its own schema, so the surface may change.

Retrieves paginated upcoming interactions linked to a person, company, or object. This endpoint is currently in open beta. The API surface may change as we iterate based on feedback. Interactions are the logged history with a contact -- meetings, calls, emails. folk marks the past/upcoming/get/update/delete family OPEN BETA in its own schema, so the surface may change.

Retrieve a list of notes in the workspace. Notes are free-text entries attached to a person, company or object.

Retrieve an existing note in the workspace. Notes are free-text entries attached to a person, company or object.

Retrieve a list of people in the workspace. People are folk's contact records. A person may belong to several groups and several companies at once. `filter` is a JSON OBJECT SUPPLIED AS TEXT -- for example `{"fullName": {"like": "Horace"}}` or `{"groups": {"in": {"id": "grp_..."}}}`. Agentic Fabriq expands it into the bracketed form folk actually accepts (`filter[fullName][like]=Horace`); folk refuses the object sent any other way with 422. Each key is a filterable attribute and each inner key an operator (`eq`, `not_eq`, `like`, `not_like`, `gt`, `lt`, `in`, `all`, `empty`, `not_empty`); an attribute folk does not recognise is refused with 422 `unrecognized_keys` naming it. `combinator` decides whether several filters are ANDed or ORed.

Retrieve an existing person in the workspace. People are folk's contact records. A person may belong to several groups and several companies at once.

Retrieve a list of reminders in the workspace. This endpoint is deprecated since August 13, 2026 and will be removed on February 13, 2027. Please use the List tasks endpoint instead. DEPRECATED by folk since 13 August 2026 and scheduled for REMOVAL on 13 February 2027; the live response carries a `deprecations` array saying so. Use the Tasks tools instead for anything new -- this one still answers 200 today and will stop.

Retrieve an existing reminder in the workspace. This endpoint is deprecated since August 13, 2026 and will be removed on February 13, 2027. Please use the Get a task endpoint instead. DEPRECATED by folk since 13 August 2026 and scheduled for REMOVAL on 13 February 2027; the live response carries a `deprecations` array saying so. Use the Tasks tools instead for anything new -- this one still answers 200 today and will stop.

Retrieve a paginated list of tasks in the workspace, optionally filtered by attributes. Tasks are folk's to-dos, each attached to a person, company or object, with a due date, optional assignees and a done/to-do state. `filter` is a JSON OBJECT SUPPLIED AS TEXT -- for example `{"fullName": {"like": "Horace"}}` or `{"groups": {"in": {"id": "grp_..."}}}`. Agentic Fabriq expands it into the bracketed form folk actually accepts (`filter[fullName][like]=Horace`); folk refuses the object sent any other way with 422. Each key is a filterable attribute and each inner key an operator (`eq`, `not_eq`, `like`, `not_like`, `gt`, `lt`, `in`, `all`, `empty`, `not_empty`); an attribute folk does not recognise is refused with 422 `unrecognized_keys` naming it. `combinator` decides whether several filters are ANDed or ORed.

Retrieve an existing task in the workspace. Tasks are folk's to-dos, each attached to a person, company or object, with a due date, optional assignees and a done/to-do state.

Returns a list of workspace users. Users are the people who work IN the folk workspace, not its contacts.

Returns the current workspace user. Users are the people who work IN the folk workspace, not its contacts. This is also the credential probe: measured 2026-09-19 it answers 200 with the key's own user object, 401 UNAUTHORIZED to a malformed key and 401 to no Authorization header at all.

Returns a workspace user. Users are the people who work IN the folk workspace, not its contacts.

Retrieve a list of webhooks in the workspace. Webhooks deliver workspace events to a URL you own. The per-webhook signing secret folk returns AT CREATION is shown once and is NOT a folk API credential: it verifies inbound deliveries to your handler (Standard Webhooks, HMAC-SHA256) and is never used to call folk.

Retrieve an existing webhook in the workspace. Webhooks deliver workspace events to a URL you own. The per-webhook signing secret folk returns AT CREATION is shown once and is NOT a folk API credential: it verifies inbound deliveries to your handler (Standard Webhooks, HMAC-SHA256) and is never used to call folk.

Update an existing company in the workspace. Companies are folk's organisation records, linked to people and to deals.

Update a group's name and/or visibility. Groups are folk's collections of contacts; a workspace is organised into them and most other resources are addressed through one.

Updates a group custom field for an entity type. Group custom fields define the extra columns a group's people, companies and custom objects carry. Listing them for the `person` entity type is also how you discover a group's object types: every field of type `objectField` names one, and its `name` is what goes in `objectType`.

Updates a group member's role. Group members are WORKSPACE USERS with access to a group, not the contacts inside it. A public group is accessible to every workspace member.

Update an existing deal in the workspace. A group can hold any object type you define -- `Deals` is the default, and `Projects`, `Applications` and so on are custom objects. They all share one set of endpoints under /v1/groups/{groupId}/{objectType}, and `objectType` is the type's name exactly as the folk app spells it (the match is CASE-SENSITIVE). List the group's custom fields for `person` to find the available names.

Partially update an existing logged interaction (title, content, date-time, activityType). Imported interactions cannot be updated. This endpoint is currently in open beta. The API surface may change as we iterate based on feedback. Interactions are the logged history with a contact -- meetings, calls, emails. folk marks the past/upcoming/get/update/delete family OPEN BETA in its own schema, so the surface may change.

Update an existing note in the workspace. Notes are free-text entries attached to a person, company or object.

Update an existing person in the workspace. People are folk's contact records. A person may belong to several groups and several companies at once.

Update an existing reminder in the workspace. This endpoint is deprecated since August 13, 2026 and will be removed on February 13, 2027. Please use the Update a task endpoint instead. DEPRECATED by folk since 13 August 2026 and scheduled for REMOVAL on 13 February 2027; the live response carries a `deprecations` array saying so. Use the Tasks tools instead for anything new -- this one still answers 200 today and will stop.

Update an existing task in the workspace. Tasks are folk's to-dos, each attached to a person, company or object, with a due date, optional assignees and a done/to-do state.

Update an existing webhook in the workspace. Webhooks deliver workspace events to a URL you own. The per-webhook signing secret folk returns AT CREATION is shown once and is NOT a folk API credential: it verifies inbound deliveries to your handler (Standard Webhooks, HMAC-SHA256) and is never used to call folk.

Create a new company in the workspace. Companies are folk's organisation records, linked to people and to deals.

Search for companies in the workspace. Companies are folk's organisation records, linked to people and to deals. `filter` is a JSON OBJECT SUPPLIED AS TEXT -- for example `{"fullName": {"like": "Horace"}}` or `{"groups": {"in": {"id": "grp_..."}}}`. Agentic Fabriq expands it into the bracketed form folk actually accepts (`filter[fullName][like]=Horace`); folk refuses the object sent any other way with 422. Each key is a filterable attribute and each inner key an operator (`eq`, `not_eq`, `like`, `not_like`, `gt`, `lt`, `in`, `all`, `empty`, `not_empty`); an attribute folk does not recognise is refused with 422 `unrecognized_keys` naming it. `combinator` decides whether several filters are ANDed or ORed.

Create a new group in the workspace. A default "All people" table view is automatically created for the group. Groups are folk's collections of contacts; a workspace is organised into them and most other resources are addressed through one.

Creates a new group custom field for an entity type. Group custom fields define the extra columns a group's people, companies and custom objects carry. Listing them for the `person` entity type is also how you discover a group's object types: every field of type `objectField` names one, and its `name` is what goes in `objectType`. folk declares this body as a `oneOf` over eight custom-field types. The union of their fields is shipped flat -- `type` is the discriminator and `options`/`config` belong to particular types -- and folk enforces the per-type rules itself, refusing a field the chosen type does not take with 422.

Adds a member to a group. Group members are WORKSPACE USERS with access to a group, not the contacts inside it. A public group is accessible to every workspace member.

Create a new deal in the workspace. A group can hold any object type you define -- `Deals` is the default, and `Projects`, `Applications` and so on are custom objects. They all share one set of endpoints under /v1/groups/{groupId}/{objectType}, and `objectType` is the type's name exactly as the folk app spells it (the match is CASE-SENSITIVE). List the group's custom fields for `person` to find the available names.

Search deals in the workspace. A group can hold any object type you define -- `Deals` is the default, and `Projects`, `Applications` and so on are custom objects. They all share one set of endpoints under /v1/groups/{groupId}/{objectType}, and `objectType` is the type's name exactly as the folk app spells it (the match is CASE-SENSITIVE). List the group's custom fields for `person` to find the available names. `filter` is a JSON OBJECT SUPPLIED AS TEXT -- for example `{"fullName": {"like": "Horace"}}` or `{"groups": {"in": {"id": "grp_..."}}}`. Agentic Fabriq expands it into the bracketed form folk actually accepts (`filter[fullName][like]=Horace`); folk refuses the object sent any other way with 422. Each key is a filterable attribute and each inner key an operator (`eq`, `not_eq`, `like`, `not_like`, `gt`, `lt`, `in`, `all`, `empty`, `not_empty`); an attribute folk does not recognise is refused with 422 `unrecognized_keys` naming it. `combinator` decides whether several filters are ANDed or ORed.

Creates a new interaction (https://help.folk.app/en/articles/7012167-log-a-new-interaction) with a person or a company. Interactions are the logged history with a contact -- meetings, calls, emails. folk marks the past/upcoming/get/update/delete family OPEN BETA in its own schema, so the surface may change.

Create a new note in the workspace. Notes are free-text entries attached to a person, company or object.

Create a new person in the workspace. People are folk's contact records. A person may belong to several groups and several companies at once.

Search for people in the workspace. People are folk's contact records. A person may belong to several groups and several companies at once. `filter` is a JSON OBJECT SUPPLIED AS TEXT -- for example `{"fullName": {"like": "Horace"}}` or `{"groups": {"in": {"id": "grp_..."}}}`. Agentic Fabriq expands it into the bracketed form folk actually accepts (`filter[fullName][like]=Horace`); folk refuses the object sent any other way with 422. Each key is a filterable attribute and each inner key an operator (`eq`, `not_eq`, `like`, `not_like`, `gt`, `lt`, `in`, `all`, `empty`, `not_empty`); an attribute folk does not recognise is refused with 422 `unrecognized_keys` naming it. `combinator` decides whether several filters are ANDed or ORed.

Create a new reminder in the workspace. This endpoint is deprecated since August 13, 2026 and will be removed on February 13, 2027. Please use the Create a task endpoint instead. DEPRECATED by folk since 13 August 2026 and scheduled for REMOVAL on 13 February 2027; the live response carries a `deprecations` array saying so. Use the Tasks tools instead for anything new -- this one still answers 200 today and will stop.

Create a new task in the workspace. Tasks are folk's to-dos, each attached to a person, company or object, with a due date, optional assignees and a done/to-do state.

Mark an existing task as done. Tasks are folk's to-dos, each attached to a person, company or object, with a due date, optional assignees and a done/to-do state.

Mark an existing task as to do. Tasks are folk's to-dos, each attached to a person, company or object, with a due date, optional assignees and a done/to-do state.

Creates a new webhook listening to workspace events. Webhooks deliver workspace events to a URL you own. The per-webhook signing secret folk returns AT CREATION is shown once and is NOT a folk API credential: it verifies inbound deliveries to your handler (Standard Webhooks, HMAC-SHA256) and is never used to call folk.