Integrations
OpenAI
How to get your OpenAI API key and connect it to Nova Admin.
Enter an OpenAI API key (default) for voice, embeddings, and media tools, or paste a ChatGPT / Codex subscription OAuth bearer token instead.
Prerequisites
- A OpenAI account. Sign up at https://platform.openai.com/api-keys.
- An active Nova Admin workspace. Go to /agents/integrations to connect.
Steps
- Go to <a href="https://platform.openai.com" target="_blank">platform.openai.com</a> and sign up or log in.
- Go to <strong>Settings → API Keys</strong> (or <code>platform.openai.com/api-keys</code>).
- Click <strong>Create new secret key</strong>, optionally name it, then copy the <code>sk-...</code> value — shown only once.
- Add a payment method under <strong>Settings → Billing</strong> if you have not already — the API requires a funded account.
- In Nova Admin, go to <strong>/agents/integrations</strong>, find <strong>OpenAI</strong>, and paste the key into the API Key field.
- Optional: to bill through a ChatGPT / Codex subscription instead, paste an OAuth bearer token into the OAuth Token field and leave API Key blank. If both are set, the API key is used.
Credential fields
| Field | Required | Description |
|---|---|---|
| API Key | No | Secret — stored encrypted, never exposed. (e.g. sk-...) |
| OAuth Token | No | Secret — stored encrypted, never exposed. (e.g. ChatGPT / Codex subscription OAuth bearer token) |
Troubleshooting
- Invalid credentials: verify the key was copied in full with no trailing spaces.
- Key not working: check that your OpenAI account has API access enabled and billing is active if required.
- Need help?: refer to the OpenAI documentation.