---
title: How to get an OpenAI API key - Workflow Suite
description: >-
  Create an OpenAI API key, connect it on the Developer page of Workflow Suite
  and pick a default GPT model to write and change functions with AI.
source_url:
  html: >-
    https://docs.workflow-suite.app/get-openai-api-key
  md: >-
    https://docs.workflow-suite.app/get-openai-api-key.md
---

# How to get an OpenAI API key

Workflow Suite can write and change the code of your functions with AI. It uses your own key from an AI provider. This page shows how to create an OpenAI API key for the GPT models, where to paste it in Workflow Suite and how to pick a default model.

## Create the key at OpenAI

1. Open the **OpenAI platform** and sign in, or create an account: <a href="https://platform.openai.com" target="_blank" rel="noopener">platform.openai.com</a>.
2. Open **API keys**. Direct link: <a href="https://platform.openai.com/api-keys" target="_blank" rel="noopener">platform.openai.com/api-keys</a>.
3. Select **Create new secret key** and give it a name, for example `Workflow Suite`.
4. Copy the key. It starts with `sk-`.
5. Make sure your OpenAI account has a billing method or credit. Generation is billed to that account.

> [!WARNING]
> **Copy the key right away**
> OpenAI shows the full key only once, when you create it. Treat it like a password: paste it into Workflow Suite and do not share it. We never need your key to help you, so leave it out of support requests.

## Paste the key into Workflow Suite

1. In your Shopify admin, open **Workflow Suite** and select **Developer** in the app menu.
2. Open the tab **Connections**. Under **Write and change functions with AI** there is one card per provider.
3. In the **OpenAI** card, paste the key into **API key**.
4. Select **Save key**.

The card then shows **Key connected** and the model it uses.

> [!NOTE]
> **What happens when you save**
> - The key is checked with OpenAI first. If OpenAI rejects it or cannot be reached, the key is not saved and a message tells you why.
> - An accepted key is stored encrypted and is never shown again. To use another key, paste it into the same field and select **Replace key**.
> - The key is used only when you generate. Your request and the function's code are then sent to OpenAI under your account.
> - Your functions cannot read this key, and it never reaches the sandbox they run in. For keys your own code needs, see [Secrets](https://docs.workflow-suite.app/secrets.md).
> - **Disconnect** deletes the saved key. Writing functions with OpenAI then stops working until you connect a key again.

## Pick a default model

Once the key is saved, the card has a **Default model** list. This model is preselected when you write a function with AI. You can pick another model each time.

- Workflow Suite starts with **GPT-6.1 Sol** when your key offers it.
- The list is OpenAI's own list for your key, with models such as **GPT-6 Astra**, **GPT-6.1 Terra** and **GPT-6 Luna**. It can show more models than these.
- An older model you already saved keeps working as long as OpenAI offers it, and the card names the newer model with a button to switch.

## Write a function with AI

1. Open **Functions** in the app menu and open a function.
2. Select **Write with AI** above the code.
3. Pick the **Model**, describe what should change and select **Generate**. With more than one provider connected, pick the **Provider** first.

The new code is loaded into the editor. Nothing is saved until you save, so review and test it first.

On a new, empty function, **Create with AI** drafts the code, sample variables and the permissions it needs from your description.

> [!NOTE]
> **Billed to your OpenAI account**
> Generation is billed to your own OpenAI account, not to your Workflow Suite plan. For models with a known price, the model list shows an estimated cost per generation. What you pay is set by OpenAI.

## Related

- [Run code and functions](https://docs.workflow-suite.app/run-code.md) - what functions are and how a workflow runs them.
- [Secrets](https://docs.workflow-suite.app/secrets.md) - keys and passwords for your own steps and code.
- [Build workflows with an AI assistant over MCP](https://docs.workflow-suite.app/build-workflows-with-ai-over-mcp.md) - a different feature: an AI assistant that builds whole workflows over MCP.
