API updates, fixes and improvements
folk API improvements and additions
-
Group improvements:
- Create a group
- Update a group
- Added the
visibilityparameter to List groups
-
Group custom fields now support managing group structure:
- Get a custom field
- Create a custom field
- Update a custom field
- Added the
idparameter to custom field options, allowing updates by ID. Format:<gpco_uuid>.
- Group members now support managing group access:
folk MCP tools update
We’ve added a new set of tools for managing your contacts and workspace, including:- List groups and other group-related tools
- List group members and other group member–related tools
- List group custom fields and other group custom field–related tools
Folk remote MCP server in open beta
The folk remote MCP server is now available in open beta. You can connect and test it today — it exposes all the operations already available in the REST API, so you can manage your workspace from AI assistants with the same capabilities as the API.Fix clearing birthday field
- Clearing the ‘birthday’ field of a person is now possible by passing null or an empty string.
Notes search and date filters
- Add
queryparameter to List notes to search notes by full-text content. - Add
createdAfterandcreatedBeforeparameters to List notes to filter notes by creation date.
Interactions endpoints
Add support for listing, retrieving, updating, and deleting interactions in the API. Past and upcoming interactions can be listed for a person, company, or object, and logged interactions can be updated or deleted.magicField custom field type deprecated
- The
magicFieldcustom field type has been deprecated and existing fields have been migrated totextFieldwith AI settings.
Add new all filter to people, companies and deals
- Add
allfilter on multi reference fields to get entities matching all listed references.
Add new fields to companies
- Add
fundingRaised,lastFundingDate,industry,foundationYearandemployeeRange, with filtering capabilities.
Webhooks endpoints
Add support for webhooks in the API, allowing you to retrieve, create, update, and delete webhooks within your workspace.Notes endpoint
- Add support for notes created by assistants
- Fix issue with notes created by users that are no longer part of the workspace
Add createdAt and createdBy fields to people, companies, deals, notes and reminders
- Add
createdAtandcreatedByfields to people, companies and deals, with filtering capabilities. - Add
createdAtfield to notes. - Add
createdAtandcreatedByfields to reminders.
Interaction endpoint
Add endpoint to create interactions on people and companies.Notes endpoints
Add support for notes in the API, allowing you to retrieve, create, update, and delete notes within your workspace.Reminders endpoints
Add support for reminders in the API, allowing you to retrieve, create, update, and delete reminders within your workspace.Deal management endpoints
Add support for deals in the API, allowing you to create, update, retrieve, and delete deals within your workspace.Deal field support in contact custom fields
Add support for deals in contact custom field values. You can now retrieve, updated deals, and filter contacts by the deal custom fields.- Update the List group custom fields endpoint to allow deal custom fields to be listed.
- Return deal custom field values when returning a person or a company.
- Allow deal custom field values to be created and updated when creating a person, updating a person, creating a company, or updating a company.
- Update the List people and List companies endpoints to allow filtering by deal custom fields.
Delete people and companies
Introduced new endpoints that allow you to delete people and companies from your workspace.Listing and filtering of people and companies
Introduced new endpoints that allow you to list all people and companies in your workspace, with filtering capabilities.Added companies endpoints
Introduced the following company endpoints:Initial release of the API.
The public API is available athttps://api.folk.app with the following endpoints: