Skip to main content
Admin keys have elevated privileges. Handle with extra care and never expose them publicly.

Generate an Admin API Key

Admin API keys are required for organization and project management actions. Only organization owners and admins can create these keys. They are created from a separate Admin keys page (not the standard API keys page).

1

Verify Admin Permissions

Ensure you have admin or owner role in your organization. You can check this in Organization settings → People (accessible via the bottom-left user menu — the section was previously called “Team”).

2

Access Admin Keys Page

1. Log in to your OpenAI account at https://platform.openai.com
2. Click your profile icon in the bottom-left menu and choose “Organization settings” (or “Profile settings”)
3. Click “Admin keys” in the left sidebar

3

Create Admin API Key

Click the ”+ Create new Admin key” button. The dialog has fields: Name, Expiration, and Permissions (no Project dropdown).

  • The key must be created by an organization admin or owner
  • Enter an optional Name (e.g., “StackOne Admin Integration”)
  • Choose an Expiration (dropdown, default ‘Never’)
  • Select Permissions: ‘All’, ‘Restricted’, or ‘Read only’ — include organization management permissions
  • Click “Create admin key”
4

Save Your Admin API Key

IMPORTANT: Copy the key immediately after creation. It will only be shown once and cannot be retrieved later.

  • Store the key in a secure password manager
  • This key has elevated privileges - handle with extra care
  • Never expose it in client-side code or public repositories

Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Admin API Key
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.