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
Prerequisites
- A Crossbeam account with access to your organization's settings
- Permission to create a custom integration (OAuth application) in 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.
Sign in to Crossbeam and go to Settings → Integrations. Open the Custom section and create a new application (custom integration).
Set the application's Callback URL to your Frontegg Redirect URL: https://YOUR_MCP_GATEWAY_URL/integration-callback
Click Create.
Open the application (click View). Crossbeam displays the Client ID and Client Secret. Copy both values.
Keep your Client Secret safe
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.
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.
Once you have your Client ID, Client Secret, and Organization ID, configure the integration in the Frontegg portal:
- Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → Crossbeam.
- Enter the Client ID and the Client Secret.
- Enter your Organization ID (the organization UUID).
- 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
Keep your credentials secure
Never share or commit your Client Secret to version control.