## Buddy integration

Buddy is a DevOps automation platform for building, testing, and deploying applications through CI/CD pipelines. Integrating Buddy with Frontegg allows your application to manage pipelines, executions, and workspaces on behalf of your users through OAuth 2.0 authentication.

Prerequisites
- A Buddy account with access to [My Apps](https://app.buddy.works/my-apps)


### Connect Buddy

#### Step 1: Open the OAuth applications page

Sign in to Buddy and navigate to your user menu by clicking the avatar in the top-right corner. Select **Apps** from the dropdown.

This opens the **My OAuth Apps** page at `https://app.buddy.works/my-apps`, which lists all OAuth applications registered under your account.

Click the **+** button to register a new application.

![Buddy My OAuth Apps page](/assets/buddy-1.f1c0fe2bc83d1d5bc36fddef0db02cf7611b77323b0037604eae813efc7a6250.1ce25488.png)

#### Step 2: Review the new application form

The **Register new** form contains the following fields:

| Field | Value |
|  --- | --- |
| **Application name** | A descriptive name, e.g., `Frontegg Integration` |
| **Homepage URL** | The URL of your application homepage |
| **Authorization callback URLs** | The Frontegg callback URIs (see step 3) |
| **Application description** | Optional description of your application |


![Buddy new application form](/assets/buddy-2.cfe3114e85e1aab8fc8fd4622b4201bf22c784c6cc1fec92c2f180dc93ce758e.1ce25488.png)

#### Step 3: Fill in the application details

Enter the following values:

- **Application name**: `Frontegg Integration`
- **Homepage URL**: The URL of your application homepage
- **Authorization callback URLs**: Enter the following URI:



```
https://YOUR_MCP_GATEWAY_URL/integration-callback
```

Click **Add new OAuth application**.

![Buddy application form filled in](/assets/buddy-3.e2cf5f5dc2ab8fabd573c60eb8a37e896a9822e224fbb1770f532d6e29132ead.1ce25488.png)

#### Step 4: Copy your client secret

After saving, Buddy displays a **Copy your client secret** dialog. Copy the secret immediately and store it securely.

One-time display
The Client Secret is shown only once. If you close this window without copying it, click **Reset client secret** on the application settings page to generate a new one — this will invalidate the previous secret.

![Buddy client secret dialog](/assets/buddy-4.6dc87c03a7ad23864df3d6534ed139c382306a3900bdce12b2f1127cc777ccc9.1ce25488.png)

#### Step 5: Copy your client ID

After confirming the secret dialog, Buddy redirects you to the application settings page. The **Client ID** is displayed at the top of the page. Copy it and store it alongside the Client Secret.

![Buddy application settings with client ID](/assets/buddy-5.ee1076017606d8441f1e50316d1f5cdd03c428361f9edce8f4cee93942426031.1ce25488.png)

### Configure the Frontegg portal

Once you have the **Client ID** and **Client Secret** from the steps above, enter them in the integration configuration page of the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → Buddy.
2. Enter the **Client ID** and **Client Secret** in the corresponding fields.
3. Select the required **scopes**:


| Scope | Description |
|  --- | --- |
| `WORKSPACE` | Access to workspace information, members, groups, and permissions |
| `USER_INFO` | Access to user profile information |
| `EXECUTION_RUN` | Permission to run and stop pipeline executions |
| `EXECUTION_INFO` | Access to execution history |
| `VARIABLE_INFO` | Access to pipeline variables |
| `INTEGRATION_INFO` | Access to workspace integrations |
| `TOKEN_INFO` | Access to token information |


1. Click **Save**.


Keep your credentials secure
Never share or commit your Client Secret to version control.

### Additional resources

- [Buddy OAuth 2.0 documentation](https://buddy.works/docs/api/getting-started/oauth2/introduction)
- [Buddy API reference](https://buddy.works/docs/api/getting-started/overview)
- [Buddy My Apps](https://app.buddy.works/my-apps)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)