---
title: Register an incoming application
description: Generate an application for use with the Casebook API
---

[Skip to content](https://gohub.casebook.net/knowledge/register-an-incoming-application#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)

# Register an incoming application

## Generate an application for use with the Casebook API

### Introduction

Interactions with the Casebook API require the configuration of one or more incoming applications with defined roles and permissions.

This developer guide walks through the creation of an incoming application for use with the Casebook API.

### Prerequisites

**Your organization must be licensed for External Data Interoperability (API)** to interact with the Casebook API.

### Instructions

Register incoming applications and assign roles with the right level of access to ensure that each application can perform only the operations you intend.

1. Navigate to *Casebook → Admin → Global → Integrations → **Incoming integrations***
2. Click on the **Register an external application** button in the bottom right corner of the page to add a new application:
   
     1. **Application name** (Required): Enter an internal name for the application that you want to register. This name will be displayed on records modified by the application in fields like “Created by” and “Last updated by”.
     2. **Email** (Required): Enter a unique email address where you would like to receive alerts and notifications about this integration. Because each application is a separate account with assigned roles, this email address cannot be associated with an existing Casebook account, including your own. See Tips below for suggestions.
     3. **Roles** (Required): Select one or more roles to define the application’s access to the Casebook system. See Tips below for suggestions.
     4. **Application URL** (Optional): Enter a URL for the application you are registering.
     5. **Description** (Optional): Describe the purpose of this incoming application.
3. Click “**Save**” to create the incoming application.

### Tips

**For stronger security, create separate applications for different use cases** or distinct permission sets rather than granting broad access to a single application

**Create a custom role for your integration **in *Admin → Global → Roles* if default roles are not a good fit

**To receive alerts and notifications about your integration sent to your email address**, consider creating aliases or subaddresses offered by some email providers including [Microsoft](https://learn.microsoft.com/en-us/exchange/recipients-in-exchange-online/plus-addressing-in-exchange-online) and [Google Workspace](https://support.google.com/a/answer/12265327?hl=en) which can be used to create unique email addresses that automatically forward messages to your inbox

### Next steps

Next, use your application to obtain an access token for use with the Casebook API:

- [Obtain a Bearer token](https://gohub.casebook.net/knowledge/obtain-a-bearer-token)

---

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)