--- title: Work with the People API description: Create, update, search, fetch, and delete people programmatically with the Casebook People API --- [Skip to content](https://gohub.casebook.net/knowledge/work-with-the-people-api#main-content) [More support](https://gohub.casebook.net/knowledge/kb-tickets/new) [![logo-raspberry (1)](https://gohub.casebook.net/hs-fs/hubfs/logo-raspberry%20(1).png?width=1286&height=255&name=logo-raspberry%20(1).png)](https://gohub.casebook.net/) - [Knowledge Base](https://gohub.casebook.net/knowledge) - [Video Library](https://gohub.casebook.net/video-library) - [Still Need Help?](https://gohub.casebook.net/knowledge/kb-tickets/new) Open main navigation Close main navigation - [Knowledge Base](https://gohub.casebook.net/knowledge) - [Video Library](https://gohub.casebook.net/video-library) - [Still Need Help?](https://gohub.casebook.net/knowledge/kb-tickets/new) - [More support](https://gohub.casebook.net/knowledge/kb-tickets/new) Hi. How can we help? - There are no suggestions because the search field is empty. 1. [Knowledge Base](https://gohub.casebook.net/knowledge) 2. [Integrations](https://gohub.casebook.net/knowledge/integrations) 3. [Custom incoming integrations with Casebook API](https://gohub.casebook.net/knowledge/integrations#custom-incoming-integrations-with-casebook-api) # Work with the People API ## Create, update, search, fetch, and delete people programmatically with the Casebook People API ### Introduction **In Casebook, People records represent individuals and their full history with your organization.** People records detail an individual's demographics and involvement across intake reports, cases, providers, and services. Operations in the [**People API**](https://documenter.getpostman.com/view/21327246/2sBXVhEB28#4969c27f-8fdf-4470-9c7e-614687952c1a) reflect the entities, attributes, and relationships that can be created in Casebook: - **People** - **Education** - **Employment** This guide focuses on the most common use cases to help you quickly integrate core intake functionality into your applications. ### Prerequisites **Your organization must be licensed for External Data Interoperability (API)** to interact with the Casebook API. **You will need to [register an incoming application](https://gohub.casebook.net/knowledge/register-an-incoming-application) and [obtain a Bearer token](https://gohub.casebook.net/knowledge/obtain-a-bearer-token)** before starting this guide. ### Instructions #### Create a Person [People - POST Person](https://documenter.getpostman.com/view/21327246/2sBXVhEB28#70984f10-48a9-4287-b491-5009f5d47e18) can be used to create a new Person in Casebook ``` POST /people/people ``` - Application Roles: - People - Create (All) - Headers: - Authorization: `Bearer ` - Content-Type: `application/vnd.api+json` - Body: Person attributes and relationships - Query parameters: N/A #### Query all People [People - GET People](https://documenter.getpostman.com/view/21327246/2sBXVhEB28#bca36d9d-99e0-461e-a50f-74ce998e5e6b) can be used to retrieve a list of People in Casebook ``` GET /people/people ``` - Application Roles: - People - View (All or Limited access) - Headers: - Authorization: `Bearer ` - Content-Type: `application/vnd.api+json` - Body: N/A - Query parameters: - `fields` (Optional): Specify the exact attributes to be included in the response payload to reduce data overhead - `filter` (Optional): Limit the retrieved results based on specific criteria or field values - `include` (Optional): Request related entities to be side-loaded and included in the response for a more comprehensive data set - `page` (Optional): Navigate through result sets by returning records in separate pages for faster performance (10 records per page by default) - `sort` (Optional): Order the results in ascending or descending order based on a specified field #### Fetch the details of a specific Person [People - GET Person by ID](https://documenter.getpostman.com/view/21327246/2sBXVhEB28#79ff9cfe-106d-41a0-a36d-5bf493b15ff0) can be used to retrieve the full details of a specific Person in Casebook ``` GET /people/people/:id ``` - Application Roles: - People - View (All or Limited access) - Headers: - Authorization: `Bearer ` - Content-Type: `application/vnd.api+json` - Body: N/A - Query parameters: - `fields` (Optional): Specify the exact attributes to be included in the response payload to reduce data overhead - `include` (Optional): Request related entities to be side-loaded and included in the response for a more comprehensive data set #### Update a Person [People - PATCH Person by ID](https://documenter.getpostman.com/view/21327246/2sBXVhEB28#032e3c3f-d29f-4b96-8acf-a913520fa546) can be used to update a Person in Casebook ``` PATCH /people/people/:id ``` - Application Roles: - People - Edit (All or Limited access) - Headers: - Authorization: `Bearer ` - Content-Type: `application/vnd.api+json` - Body: Person attributes and relationships - Query parameters: N/A #### Delete a Person [People - DELETE Person by ID](https://documenter.getpostman.com/view/21327246/2sBXVhEB28#624a0a20-afdd-4b3e-8b17-4ce8c48432cc) can be used to soft-delete a Person in Casebook ``` DELETE /people/people/:id ``` - Application Roles: - People - Delete (All or Limited access) - Headers: - Authorization: `Bearer ` - Content-Type: `application/vnd.api+json` - Body: N/A - Query Parameters: N/A ### Tips **All required fields must be provided to create or update records** - see *Admin → People → Dynamic pages* for a list of fields which have been set to required in Casebook **An ID must be provided to fetch, update, or delete a specific record** - If Person ID is unknown, you can first *Query all People* to fetch its value **Only the attributes included in your request will be created or updated** - you do not need to include attributes which are empty or have not changed **Deleting records hides them from view in Casebook and Reporting** - [contact Casebook Support if you need to permanently purge records](https://gohub.casebook.net/knowledge/get-help-in-casebook) ### Next steps Next, explore all endpoints available in the People API to plan your integration or learn how to access custom fields in People: - [Work with custom fields](https://gohub.casebook.net/knowledge/work-with-custom-fields) --- For more help with the Casebook API, [get in touch with the Casebook Support team](https://gohub.casebook.net/knowledge/get-help-in-casebook). - [Getting Started With Casebook](https://gohub.casebook.net/knowledge/getting-started-with-casebook#main-content) - [Casebook Overview](https://gohub.casebook.net/knowledge/getting-started-with-casebook#casebook-overview) - [Getting Started for New Users](https://gohub.casebook.net/knowledge/getting-started-with-casebook#getting-started-for-new-users) - [Services in Casebook](https://gohub.casebook.net/knowledge/getting-started-with-casebook#services-in-casebook) - [Notes](https://gohub.casebook.net/knowledge/getting-started-with-casebook#notes) - [Admin](https://gohub.casebook.net/knowledge/admin#main-content) - [Casebook Security](https://gohub.casebook.net/knowledge/admin#casebook-security) - [Roles and Permissions](https://gohub.casebook.net/knowledge/admin#roles-and-permissions) - [User Management](https://gohub.casebook.net/knowledge/admin#user-management) - [Notifications](https://gohub.casebook.net/knowledge/admin#notifications) - [Data](https://gohub.casebook.net/knowledge/admin#data) - [Field Configuration](https://gohub.casebook.net/knowledge/admin#field-configuration) - [Dynamic Fields](https://gohub.casebook.net/knowledge/admin#dynamic-fields) - [Forms](https://gohub.casebook.net/knowledge/admin#forms) - [Implementation & Adoption](https://gohub.casebook.net/knowledge/admin#implementation-adoption) - [People](https://gohub.casebook.net/knowledge/people) - [Intake](https://gohub.casebook.net/knowledge/intake) - [Engage](https://gohub.casebook.net/knowledge/engage#main-content) - [Text Messages](https://gohub.casebook.net/knowledge/engage#text-messages) - [Configuration](https://gohub.casebook.net/knowledge/engage#configuration) - [Notes](https://gohub.casebook.net/knowledge/engage#notes) - [Track](https://gohub.casebook.net/knowledge/track) - [Access](https://gohub.casebook.net/knowledge/access) - [Workflow & Tasks](https://gohub.casebook.net/knowledge/workflow-tasks) - [Reporting](https://gohub.casebook.net/knowledge/reporting#main-content) - [Overview](https://gohub.casebook.net/knowledge/reporting#overview) - [Datasets](https://gohub.casebook.net/knowledge/reporting#datasets) - [Dashboards](https://gohub.casebook.net/knowledge/reporting#dashboards) - [Pre-built Reports](https://gohub.casebook.net/knowledge/reporting#pre-built-reports) - [Custom Reports](https://gohub.casebook.net/knowledge/reporting#custom-reports) - [Data Visualizations](https://gohub.casebook.net/knowledge/reporting#data-visualizations) - [Filters](https://gohub.casebook.net/knowledge/reporting#filters) - [Calculated Fields](https://gohub.casebook.net/knowledge/reporting#calculated-fields) - [Other](https://gohub.casebook.net/knowledge/reporting#other) - [Audit Logs](https://gohub.casebook.net/knowledge/audit-logs) - [Integrations](https://gohub.casebook.net/knowledge/integrations#main-content) - [Low-code incoming integrations with Zapier](https://gohub.casebook.net/knowledge/integrations#low-code-incoming-integrations-with-zapier) - [Custom incoming integrations with Casebook API](https://gohub.casebook.net/knowledge/integrations#custom-incoming-integrations-with-casebook-api) - [Custom outgoing integrations with Webhooks](https://gohub.casebook.net/knowledge/integrations#custom-outgoing-integrations-with-webhooks) - [Program Area Specific](https://gohub.casebook.net/knowledge/program-area-specific#main-content) - [VOCA Reporting](https://gohub.casebook.net/knowledge/program-area-specific#voca-reporting) - [Customer Support](https://gohub.casebook.net/knowledge/customer-support#main-content) - [Getting Unstuck](https://gohub.casebook.net/knowledge/customer-support#getting-unstuck) - [Account Management](https://gohub.casebook.net/knowledge/customer-support#account-management) - [Product Release Notes](https://gohub.casebook.net/knowledge/product-release-notes#main-content) - [2026](https://gohub.casebook.net/knowledge/product-release-notes#2026) - [2025](https://gohub.casebook.net/knowledge/product-release-notes#2025) - [2024](https://gohub.casebook.net/knowledge/product-release-notes#2024) - [2023](https://gohub.casebook.net/knowledge/product-release-notes#2023) - [2022](https://gohub.casebook.net/knowledge/product-release-notes#2022) - [2021](https://gohub.casebook.net/knowledge/product-release-notes#2021) - [2020](https://gohub.casebook.net/knowledge/product-release-notes#2020) - [Frequently Asked Questions](https://gohub.casebook.net/knowledge/frequently-asked-questions#main-content) - [Global](https://gohub.casebook.net/knowledge/frequently-asked-questions#global) - [Casebook Calendar](https://gohub.casebook.net/knowledge/frequently-asked-questions#casebook-calendar) - [Casebook Services](https://gohub.casebook.net/knowledge/frequently-asked-questions#casebook-services) - [Casebook Forms](https://gohub.casebook.net/knowledge/frequently-asked-questions#casebook-forms) - [Casebook Notes](https://gohub.casebook.net/knowledge/frequently-asked-questions#casebook-notes) - [cb Admin](https://gohub.casebook.net/knowledge/frequently-asked-questions#cb-admin) - [cb Track](https://gohub.casebook.net/knowledge/frequently-asked-questions#cb-track) - [cb Reporting](https://gohub.casebook.net/knowledge/frequently-asked-questions#cb-reporting) - [cb Access](https://gohub.casebook.net/knowledge/frequently-asked-questions#cb-access) - [Program Specific](https://gohub.casebook.net/knowledge/frequently-asked-questions#program-specific) [![logo-raspberry-1-1](https://gohub.casebook.net/hs-fs/hubfs/logo-raspberry-1-1.png?width=32&height=30&name=logo-raspberry-1-1.png "logo-raspberry-1-1")](https://www.casebook.net/) © 2025 Casebook. All rights reserved. Casebook Knowledge Base [Video Library](https://gohub.casebook.net/video-library) [Still Need Help?](https://gohub.casebook.net/knowledge/kb-tickets/new)