## Crossbeam integration

Crossbeam is a partner ecosystem platform that lets companies find overlapping accounts and collaborate with partners. Integrating Crossbeam with Frontegg lets your application read partnerships, populations, and reports, work with threads, and read the current profile on behalf of your users — all through Frontegg's integration layer. Crossbeam authenticates with OAuth 2.0 (Authorization Code flow), and every Partner API request is scoped to a specific Crossbeam organization, so you also provide your **Organization ID**.

Prerequisites
- A [Crossbeam](https://www.crossbeam.com/) account with access to your organization's settings
- Permission to create a custom integration (OAuth application) in Crossbeam


### Connect to Crossbeam

You register an OAuth 2.0 application in Crossbeam. The application provides the **Client ID** and **Client Secret** and defines the **callback (redirect) URL** that Crossbeam returns users to after they authorize access. You also need your Crossbeam **Organization ID**.

#### Step 1: Create a custom integration

Sign in to Crossbeam and go to **Settings → Integrations**. Open the **Custom** section and create a new application (custom integration).

#### Step 2: Set the callback URL

Set the application's **Callback URL** to your Frontegg Redirect URL: `https://YOUR_MCP_GATEWAY_URL/integration-callback`

Click **Create**.

#### Step 3: Copy the Client ID and Client Secret

Open the application (click **View**). Crossbeam displays the **Client ID** and **Client Secret**. Copy both values.

Keep your Client Secret safe
The Client Secret grants access to your account through the API. Treat it like a password and never expose it in client-side code or commit it to version control.

#### Step 4: Find your Organization ID

Every Crossbeam Partner API request is scoped to one organization. Your **Organization ID** is a UUID (for example `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`). You can find it in your Crossbeam organization settings, or by calling the Partner API "current user" endpoint (`GET https://api.crossbeam.com/v0.1/users/me`), which returns the organization UUID.

### Configure the Frontegg portal

Once you have your **Client ID**, **Client Secret**, and **Organization ID**, configure the integration in the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → Crossbeam.
2. Enter the **Client ID** and the **Client Secret**.
3. Enter your **Organization ID** (the organization UUID).
4. Click **Save**.


Frontegg requests the following scopes during authorization:

| Scope | Description |
|  --- | --- |
| `read:partnerships` | Read partnerships |
| `read:populations` | Read populations |
| `read:reports` | Read reports |
| `read:threads` | Read threads |
| `write:threads` | Create and update threads |
| `read:profile` | Read the current user profile |
| `offline_access` | Obtain a refresh token for long-lived access |


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

### Additional resources

- [Crossbeam Partner API documentation](https://developers.crossbeam.com/)
- [Crossbeam website](https://www.crossbeam.com/)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)