OpenAI

Manage Synthflow from ChatGPT or Codex, or run models with your own OpenAI API key
View as Markdown

Synthflow AI integration with OpenAI

The Synthflow plugin lets you manage your workspace with natural-language prompts in both ChatGPT and Codex.

You can also bring your own API key so that Synthflow runs supported models with your own OpenAI credentials. This is independent from the plugin: it changes which credentials power model access for your agents, not how you manage your workspace.

What you can do

Ask ChatGPT or Codex to:

  • Build and update agents: Create agents, draft and refine prompts, publish drafts, and compare versions before you go live.
  • Manage calls: Place test calls, review recent calls, and surface summaries or negative-sentiment moments when you ask.
  • Manage knowledge: Create knowledge bases, add items from files or URLs, and attach them to the agents that should use them.
  • Run actions and simulations: Scaffold and test actions, then run simulations to validate behavior before launch.

Plugin installation

The Synthflow plugin works the same way in both ChatGPT and Codex. You sign in through Synthflow, so there is no API key to copy or manage by hand. Know which region your workspace belongs to, then connect the Synthflow plugin to the matching MCP server URL:

RegionMCP URL
Globalhttps://mcp.synthflow.ai/mcp
United Stateshttps://mcp.us.synthflow.ai/mcp
European Unionhttps://mcp.eu.synthflow.ai/mcp
The server URL and your workspace must be in the same region. A mismatch, such as the EU URL with a US workspace, stops the connection from working.

You are redirected to Synthflow to log in, where you select the workspace you want to manage.

Selecting a Synthflow workspace during connection

After you select the workspace, click Allow access on the next screen and the connection is established. You can then start prompting.

Example prompts

Example prompt
List my agents and summarize what each one does.
Create a new inbound sales qualification agent and publish it.
Show me the last 20 calls and flag any with negative sentiment.
Create a knowledge base from these sources, then attach it to my support agent.
Run a simulation where a prospect asks about pricing and implementation time.

Security considerations

Connecting an AI tool to operational tools introduces new risks. The primary risk class unique to these workflows is prompt injection: untrusted content (like call transcripts, user messages, or knowledge base documents) can include instructions that try to trick the model into taking unintended actions. Keep confirm before running tools enabled and review each action carefully.

Bring your own key

Connect your OpenAI API key when you want Synthflow to run supported models with your own credentials instead of a shared key. This is separate from the Synthflow plugin above: it changes which credentials power model access for your agents, not how you manage your workspace.

Before you connect

Make sure you have:

Generate the key in your OpenAI account settings, then copy it before you return to Synthflow. OpenAI shows the full key value only once.

Connect your API key in Synthflow

1

Go to AdminWorkspace SettingsIntegrations.

2

Find OpenAI and select it.

3

Enter your API Key, then click Connect to save the integration.

After connection, Synthflow routes supported LLM traffic through your OpenAI account using your API key. Billing and usage limits follow the terms of your OpenAI account.

FAQ

The Synthflow plugin lets you manage your workspace with natural-language prompts in ChatGPT and Codex. BYOK is separate: it tells Synthflow to run supported models with your own OpenAI credentials. You can use any combination.

Aurora is the in-dashboard agent: one chat thread in the Synthflow UI with Memory, Learnings, and rich UI cards. The Synthflow plugin runs inside ChatGPT or Codex and manages the workspace you connect. All draw on the same capabilities.

Create one in the OpenAI API keys dashboard. Copy the key before you leave the page.

The OpenAI API key integration appears only when BYOK access is enabled for your account. Contact your account team if you need this option added.

ChatGPT and Codex run in your own OpenAI account, so model and subscription charges are billed by OpenAI according to your plan. Synthflow bills only for the workspace usage your actions generate, such as calls, under your existing Synthflow plan.

Yes. If you run models through Azure OpenAI, connect Azure and provide your Azure endpoint, API version, and API key.