> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firstresonance.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage OAuth apps

> Register a custom application to authenticate with the ION API using OAuth 2.0.

OAuth applications let your custom tools and integrations authenticate with the ION API. ION supports two app types: web and desktop apps using the PKCE flow, and IoT or limited-input devices using the Device Authorization Grant.

## Register an app

1. In ION, go to **Settings > Organization > OAuth Apps**.
2. Click **Register App**.
3. Enter an **Application Name**.
4. Select the application type:
   * **Web / Desktop App (PKCE)**: For web or desktop applications using the Authorization Code + PKCE flow.
   * **Device / Wearable**: For IoT devices or limited-input devices using the Device Authorization Grant.
5. Click **Register**.

Copy the **Client ID** from the app's entry for use in your application.

## Add redirect URIs (web / desktop apps only)

After registering a web or desktop app, add the URIs your application uses:

1. In the app's entry, click **Add Callback URL** and enter your callback URL (for example, `https://your-app.com/callback`).
2. Optional: Add any of the following:
   * Click **Add Origin** to add an allowed CORS origin.
   * Click **Add Logout URL** to add a post-logout redirect URL.

## Delete an app

1. In ION, go to **Settings > Organization > OAuth Apps**.
2. In the app's entry, click the delete icon.
3. Confirm the deletion.

<Warning>
  Deleting an OAuth app revokes access for all applications using that client ID. This cannot be undone.
</Warning>

## Related

* [API reference](/api-reference)
