# Folk Developer Portal > Developer portal and API reference of folk - [Welcome to folk](https://developer.folk.app/index.md): Build integrations with folk's API to manage relationships for your service business - [Quick start](https://developer.folk.app/guides/quick-start.md) - [Introduction](https://developer.folk.app/core-concepts/introduction.md) - [People](https://developer.folk.app/core-concepts/people.md) - [Companies](https://developer.folk.app/core-concepts/companies.md) - [Deals](https://developer.folk.app/core-concepts/deals.md) - [Groups](https://developer.folk.app/core-concepts/groups.md) - [Custom fields](https://developer.folk.app/core-concepts/custom-fields.md) - [Typeform integration using n8n](https://developer.folk.app/use-cases/n8n-typeform.md) - [About webhooks](https://developer.folk.app/webhooks/about.md) - [Events & payloads](https://developer.folk.app/webhooks/events-and-payloads.md) - [Create webhooks](https://developer.folk.app/webhooks/create-webhooks.md) - [Handle deliveries](https://developer.folk.app/webhooks/handle-deliveries.md) - [Migrate from reminders to tasks](https://developer.folk.app/migrations/reminders-to-tasks.md) - [Overview](https://developer.folk.app/api-reference/overview.md) - [Authentication](https://developer.folk.app/api-reference/authentication.md) - [Errors](https://developer.folk.app/api-reference/errors.md) - [Pagination](https://developer.folk.app/api-reference/pagination.md) - [Filtering](https://developer.folk.app/api-reference/filtering.md) - [Rate limits](https://developer.folk.app/api-reference/rate-limits.md) - [Request ID](https://developer.folk.app/api-reference/request-id.md) - [Versioning](https://developer.folk.app/api-reference/versioning.md) - [List people](https://developer.folk.app/api-reference/people/list-people.md): Retrieve a list of people in the workspace. - [Create a person](https://developer.folk.app/api-reference/people/create-a-person.md): Create a new person in the workspace. - [Get a person](https://developer.folk.app/api-reference/people/get-a-person.md): Retrieve an existing person in the workspace. - [Delete a person](https://developer.folk.app/api-reference/people/delete-a-person.md): Delete an existing person in the workspace. - [Update a person](https://developer.folk.app/api-reference/people/update-a-person.md): Update an existing person in the workspace. - [List companies](https://developer.folk.app/api-reference/companies/list-companies.md): Retrieve a list of companies in the workspace. - [Create a company](https://developer.folk.app/api-reference/companies/create-a-company.md): Create a new company in the workspace. - [Get a company](https://developer.folk.app/api-reference/companies/get-a-company.md): Retrieve an existing company in the workspace. - [Delete a company](https://developer.folk.app/api-reference/companies/delete-a-company.md): Delete an existing company in the workspace. - [Update a company](https://developer.folk.app/api-reference/companies/update-a-company.md): Update an existing company in the workspace. - [List group members](https://developer.folk.app/api-reference/group-members/list-group-members.md): Returns a list of the group members. For a public group, all workspace members are members of the group. - [Add a group member](https://developer.folk.app/api-reference/group-members/add-a-group-member.md): Adds a member to a group. - [Remove a group member](https://developer.folk.app/api-reference/group-members/remove-a-group-member.md): Removes a member from a group. - [Update a group member](https://developer.folk.app/api-reference/group-members/update-a-group-member.md): Updates a group member's role. - [List group custom fields](https://developer.folk.app/api-reference/group-custom-fields/list-group-custom-fields.md): Returns a list of group custom fields for an entity type. - [Create a group custom field](https://developer.folk.app/api-reference/group-custom-fields/create-a-group-custom-field.md): Creates a new group custom field for an entity type. - [Get a group custom field](https://developer.folk.app/api-reference/group-custom-fields/get-a-group-custom-field.md): Returns a detailed group custom field for an entity type. - [Update a group custom field](https://developer.folk.app/api-reference/group-custom-fields/update-a-group-custom-field.md): Updates a group custom field for an entity type. - [List deals](https://developer.folk.app/api-reference/deals/list-deals.md): Retrieve a list of deals in the workspace. - [Create a deal](https://developer.folk.app/api-reference/deals/create-a-deal.md): Create a new deal in the workspace. - [Get a deal](https://developer.folk.app/api-reference/deals/get-a-deal.md): Retrieve an existing deal in the workspace. - [Delete a deal](https://developer.folk.app/api-reference/deals/delete-a-deal.md): Delete an existing deal in the workspace. - [Update a deal](https://developer.folk.app/api-reference/deals/update-a-deal.md): Update an existing deal in the workspace. - [List groups](https://developer.folk.app/api-reference/groups/list-groups.md): Returns a list of workspace groups. - [Create a group](https://developer.folk.app/api-reference/groups/create-a-group.md): Create a new group in the workspace. A default "All people" table view is automatically created for the group. - [Update a group](https://developer.folk.app/api-reference/groups/update-a-group.md): Update a group's name and/or visibility. - [List users](https://developer.folk.app/api-reference/users/list-users.md): Returns a list of workspace users. - [Get the current user](https://developer.folk.app/api-reference/users/get-the-current-user.md): Returns the current workspace user. - [Get a user](https://developer.folk.app/api-reference/users/get-a-user.md): Returns a workspace user. - [List notes](https://developer.folk.app/api-reference/notes/list-notes.md): Retrieve a list of notes in the workspace. - [Create a note](https://developer.folk.app/api-reference/notes/create-a-note.md): Create a new note in the workspace. - [Get a note](https://developer.folk.app/api-reference/notes/get-a-note.md): Retrieve an existing note in the workspace. - [Delete a note](https://developer.folk.app/api-reference/notes/delete-a-note.md): Delete an existing note in the workspace. - [Update a note](https://developer.folk.app/api-reference/notes/update-a-note.md): Update an existing note in the workspace. - [List reminders](https://developer.folk.app/api-reference/reminders/list-reminders.md): 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. - [Create a reminder](https://developer.folk.app/api-reference/reminders/create-a-reminder.md): 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. - [Get a reminder](https://developer.folk.app/api-reference/reminders/get-a-reminder.md): 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. - [Delete a reminder](https://developer.folk.app/api-reference/reminders/delete-a-reminder.md): 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. - [Update a reminder](https://developer.folk.app/api-reference/reminders/update-a-reminder.md): 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. - [List tasks](https://developer.folk.app/api-reference/tasks/list-tasks.md): Retrieve a paginated list of tasks in the workspace, optionally filtered by attributes. - [Create a task](https://developer.folk.app/api-reference/tasks/create-a-task.md): Create a new task in the workspace. - [Get a task](https://developer.folk.app/api-reference/tasks/get-a-task.md): Retrieve an existing task in the workspace. - [Delete a task](https://developer.folk.app/api-reference/tasks/delete-a-task.md): Delete an existing task in the workspace. - [Update a task](https://developer.folk.app/api-reference/tasks/update-a-task.md): Update an existing task in the workspace. - [Mark a task as done](https://developer.folk.app/api-reference/tasks/mark-a-task-as-done.md): Mark an existing task as done. - [Mark a task as to do](https://developer.folk.app/api-reference/tasks/mark-a-task-as-to-do.md): Mark an existing task as to do. - [Create an interaction](https://developer.folk.app/api-reference/interactions/create-an-interaction.md): Creates a new [interaction](https://help.folk.app/en/articles/7012167-log-a-new-interaction) with a person or a company. - [(Beta) List past interactions](https://developer.folk.app/api-reference/interactions/list-past-interactions.md): 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. - [(Beta) List upcoming interactions](https://developer.folk.app/api-reference/interactions/list-upcoming-interactions.md): 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. - [(Beta) Get a past or upcoming interaction](https://developer.folk.app/api-reference/interactions/get-a-past-or-upcoming-interaction.md): 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. - [(Beta) Delete an interaction](https://developer.folk.app/api-reference/interactions/delete-an-interaction.md): 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. - [(Beta) Update an interaction](https://developer.folk.app/api-reference/interactions/update-an-interaction.md): 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. - [List webhooks](https://developer.folk.app/api-reference/webhooks/list-webhooks.md): Retrieve a list of webhooks in the workspace. - [Create a webhook](https://developer.folk.app/api-reference/webhooks/create-a-webhook.md): Creates a new webhook listening to workspace events. - [Get a webhook](https://developer.folk.app/api-reference/webhooks/get-a-webhook.md): Retrieve an existing webhook in the workspace. - [Delete a webhook](https://developer.folk.app/api-reference/webhooks/delete-a-webhook.md): Delete an existing webhook in the workspace. - [Update a webhook](https://developer.folk.app/api-reference/webhooks/update-a-webhook.md): Update an existing webhook in the workspace. - [Overview](https://developer.folk.app/mcp/overview.md): Learn how to connect AI agents to your folk workspace - [Connecting to folk MCP](https://developer.folk.app/mcp/connect.md): Learn how to connect your AI tool to folk using MCP - [Supported tools](https://developer.folk.app/mcp/tools.md): Learn what you can do with folk MCP tools - [Security best practices](https://developer.folk.app/mcp/security-best-practices.md): Learn how to keep your workspace secure when using folk MCP - [Changelog](https://developer.folk.app/changelog.md) - [Roadmap](https://developer.folk.app/roadmap.md) ## OpenAPI Specs - [openapi](/api-reference/openapi.json) - [2025-06-09](/schemas/2025-06-09.json)