Creating an OAuth Client

This guide explains how to generate the credentials necessary for your integration to authenticate via the OAuth 2.0 protocol.

Overview

To interact with Penneo’s API securely, your application must identify itself using an OAuth Client. This ensures that data remains protected while allowing your integration to perform actions on behalf of a user.

Prerequisites

Before you begin, ensure you meet the following requirements:

• Role: You must have Administrator permissions on the Penneo account.

• Access: You must be able to log in to the Penneo Web Application.

Step-by-Step Configuration

1. Login to Penneo Log in to the Penneo web application. Ensure you are logged into the correct account where you have administrative rights.

2. Navigate to OAuth Clients In the main navigation menu, go to Configure and select OAuth Clients.

3. Create a New Client Click the Create new client button to begin the generation process.

4. Configure Client Details Enter your application name and specify your redirect_uris. Note that while you can update the redirect URIs at any time, the client name should be descriptive of your integration.

Security Warning: Credentials

Immediate Action Required: Store your client_id and client_secret in a secure vault (e.g., Azure Key Vault, 1Password) immediately after creation.

• The client_secret will only be displayed once. > * If lost, you will need to delete the client and create a new one.

• redirect_uris can be updated later if your callback URLs change.