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
- In ION, go to Settings > Organization > OAuth Apps.
- Click Register App.
- Enter an Application Name.
- 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.
- 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:
- In the app’s entry, click Add Callback URL and enter your callback URL (for example,
https://your-app.com/callback).
- 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
- In ION, go to Settings > Organization > OAuth Apps.
- In the app’s entry, click the delete icon.
- Confirm the deletion.
Deleting an OAuth app revokes access for all applications using that client ID. This cannot be undone.