Skip to main content
Keep your API keys secure. Never share them publicly or commit them to version control. Rotate keys regularly for enhanced security.

​
Generate a Standard API Key

Standard API keys provide access to most OpenAI API features including models, completions, embeddings, and more.

1

Access API Keys Page

1. Log in to your OpenAI account at https://platform.openai.com
2. Click “API keys” in the left sidebar
3. Or directly visit https://platform.openai.com/api-keys

2

Create a New API Key

Click the “Create new secret key” button to generate a new API key. The dialog shows fields in this order: Name, Project, Permissions.

  • Enter a descriptive name (e.g., “StackOne Integration”)
  • Select a Project (required — the Create button stays disabled until a project is selected)
  • Select permissions: Choose ‘All’ for full access or customize based on your needs
  • Click “Create secret key”
3

Save Your 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
  • Never expose it in client-side code or public repositories
  • Use environment variables for application deployment

​
Generate an Admin API Key (Optional)

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. Click your profile icon in the bottom-left menu and choose “Organization settings” (or “Profile settings”)
2. 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”
  • This key will have elevated privileges - handle with extra care

​
API Key Best Practices

Follow these security best practices to protect your API keys.

1

Security Recommendations

Implement these security measures to protect your API keys.

  • Scope each key to a specific Project to limit blast radius if a key is compromised
  • Create separate keys for different applications or environments
  • Set expiration dates on keys and rotate them regularly
  • Monitor API key usage in the Usage dashboard
  • Immediately revoke compromised keys
2

Rate Limits and Usage

Be aware of rate limits and monitor your usage to avoid service interruptions.

​
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:
  • API Key
  • 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.