# openai_ads_upload_image_url

> Import a public HTTPS image through the documented JSON upload endpoint after saved preview and confirmation.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [ChatGPT Ads](https://www.getmcpads.com/docs/sources/chatgpt-ads)

Import a public HTTPS image through the documented JSON upload endpoint after saved preview and confirmation. Returns native file_id. The native provider validates the image; account branding is untouched.

> **Note** Connect with the Ads Management API key from Ads Manager Settings, then select the verified advertising account. Native account permissions and feature eligibility apply.

> **Warning** This tool changes the account. It is absent from the tool list on the Free plan, and it previews by default: without `confirm: true` it describes the change and applies nothing.

|  |  |
| --- | --- |
| Source | [ChatGPT Ads](https://www.getmcpads.com/docs/sources/chatgpt-ads) |
| Kind | Write |
| Discovery | Reachable through `search_tools` and `run_tool` |
| Account parameter | `adAccountId` |
| Endpoint | https://mcp.getmcpads.com/openai-ads/mcp |

## Parameters

| Name | Type | Required | Notes |
| --- | --- | --- | --- |
| `adAccountId` | string | Required | Exact verified and selected ChatGPT Ads account ID; the token is scoped to this account. |
| `imageUrl` | string | Required | Exact public PNG/JPEG/WebP image URL approved by the person. OpenAI downloads and validates the image; use binary upload for frozen bytes. |
| `requestId` | string | Required | Stable UUID for this exact logical change. Reuse to retrieve its receipt; never replace after an uncertain outcome. |
| `confirm` | boolean | Optional | False returns a saved preview. True applies only the exact preview explicitly approved by the person. Default: `false`. |
| `confirmationToken` | string | Optional | Exact saved preview token returned for these arguments, account, actor and workspace. |

## Calling it

Through run_tool, since it is not announced

```json
{
  "name": "run_tool",
  "arguments": {
    "name": "openai_ads_upload_image_url",
    "args": {
      "adAccountId": "<string>",
      "imageUrl": "<string>",
      "requestId": "<string>"
    }
  }
}
```

- [ChatGPT Ads metrics](https://www.getmcpads.com/docs/sources/chatgpt-ads/metrics): What you can ask for.
- [ChatGPT Ads dimensions](https://www.getmcpads.com/docs/sources/chatgpt-ads/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/chatgpt-ads/tools/openai_ads_upload_image_url
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.