> ## Documentation Index
> Fetch the complete documentation index at: https://help.get-ryze.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect OpenAI Ads

> Connect OpenAI Ads with an API key.

OpenAI Ads connects with an **API key** you generate in the OpenAI Ads dashboard.

## Step 1 — Get your API key

<Steps>
  <Step title="Open OpenAI Ads">
    Go to [ads.openai.com](https://ads.openai.com/) and sign in (or sign up) to the Ads Manager.

    <Frame>
      <img src="https://mintcdn.com/ryzeai-5f9aafd5/hhGclROS6mxLcKNP/images/openai-landing.webp?fit=max&auto=format&n=hhGclROS6mxLcKNP&q=85&s=7b1ffa02179f2284e0c776ec85254bda" alt="The OpenAI Ads landing page" width="1600" height="865" data-path="images/openai-landing.webp" />
    </Frame>
  </Step>

  <Step title="Open Settings">
    In the Ads Manager, open **Settings** from the left menu.

    <Frame>
      <img src="https://mintcdn.com/ryzeai-5f9aafd5/_Hs1iqBZoiFGN0ne/images/openai-settings-nav.webp?fit=max&auto=format&n=_Hs1iqBZoiFGN0ne&q=85&s=c470d693036289e21ad11dde13e65093" alt="Navigate to Settings in OpenAI Ads Manager" width="1600" height="865" data-path="images/openai-settings-nav.webp" />
    </Frame>
  </Step>

  <Step title="Create a new API key">
    Under **Settings → General → Account Info**, click **Create New Key**. Give it a name like `Ryze`, then click **Create**. Copy the key — you'll need it next.

    <Frame>
      <img src="https://mintcdn.com/ryzeai-5f9aafd5/_Hs1iqBZoiFGN0ne/images/openai-create-key.webp?fit=max&auto=format&n=_Hs1iqBZoiFGN0ne&q=85&s=078fc86c74aa14ccb0e1ab4276688cf6" alt="Create a new API key in OpenAI Ads" width="1600" height="865" data-path="images/openai-create-key.webp" />
    </Frame>
  </Step>
</Steps>

## Step 2 — Connect in Ryze

On the **Integrations** page, click **Connect** on the **OpenAI Ads** card, paste your API key (it starts with `sk-svcacct-`) into **API key**, and click **Continue**.

To add another OpenAI Ads account, click **View** → **Add one more account**.

<Frame>
  <img src="https://mintcdn.com/ryzeai-5f9aafd5/hhGclROS6mxLcKNP/images/openai-connect-ryze.webp?fit=max&auto=format&n=hhGclROS6mxLcKNP&q=85&s=9edf2155839ee98c7b70488ab3e6af1b" alt="The Connect OpenAI Ads dialog in Ryze" width="1600" height="904" data-path="images/openai-connect-ryze.webp" />
</Frame>

## Troubleshooting

* **"That is not an OpenAI Ads API key. The key starts with sk-svcacct-…"** — the value doesn't look like an API key at all. Copy the whole key from [ads.openai.com](https://ads.openai.com/).
* **"OpenAI Ads rejected this API key. Generate a new key in the OpenAI Ads dashboard and paste the whole value."** — OpenAI Ads doesn't accept this key. Usually it's a regular OpenAI platform key (`sk-proj-…`). Create the key in the OpenAI Ads dashboard (**Settings → General → Account Info**) and paste the whole value.

Need help? Email [support@get-ryze.ai](mailto:support@get-ryze.ai).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.