---
title: "Update an ad"
method: PATCH
path: "/ads/{connection_id}/ad/{id}"
tags: ["ads", "ad"]
---

# Update an ad

`PATCH /ads/{connection_id}/ad/{id}`

## Path parameters

- `connection_id` string, required
- `id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- AdsAd
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `name` string
  - `campaign_id` string
  - `group_id` string
  - `organization_id` string
  - `status` 'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
  - `ad_type` 'TEXT' | 'IMAGE' | 'VIDEO' | 'RESPONSIVE' | 'SHOPPING' | 'APP' | 'CALL' | 'CAROUSEL' | 'SOCIAL' | 'DISPLAY' | 'SEARCH' | 'AUDIO' | 'YOUTUBE' | 'NATIVE' | 'CTV' | 'DOOH'
  - `advertiser_name` string
  - `creative_ids` string[]
  - `creative_asset_url` string
  - `ad_copy` string
  - `headline` string
  - `description` string
  - `cta` string
  - `final_url` string
  - `display_url` string
  - `path1` string
  - `path2` string
  - `promoted` AdsPromoted[]
    - `id` string, required
    - `name` string
    - `type` 'PAGE_ID' | 'APP_ID' | 'STORE_URL' | 'PIXEL_ID' | 'CUSTOM_CONVERSION_ID' | 'CATALOG_ID' | 'PRODUCT_SET_ID' | 'PRIORITIZED_SET_ID' | 'EVENT_ID' | 'OFFER_ID' | 'LEAD_FORM_ID' | 'MESSAGING_CHANNEL_ID' | 'PRODUCT_ID' | 'TWEET_ID' | 'AD_GROUP_TYPE', required
    - `raw` object
  - `logo_creative_id` string
  - `raw` object

## Response `200`

Successful

- AdsAd
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `name` string
  - `campaign_id` string
  - `group_id` string
  - `organization_id` string
  - `status` 'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
  - `ad_type` 'TEXT' | 'IMAGE' | 'VIDEO' | 'RESPONSIVE' | 'SHOPPING' | 'APP' | 'CALL' | 'CAROUSEL' | 'SOCIAL' | 'DISPLAY' | 'SEARCH' | 'AUDIO' | 'YOUTUBE' | 'NATIVE' | 'CTV' | 'DOOH'
  - `advertiser_name` string
  - `creative_ids` string[]
  - `creative_asset_url` string
  - `ad_copy` string
  - `headline` string
  - `description` string
  - `cta` string
  - `final_url` string
  - `display_url` string
  - `path1` string
  - `path2` string
  - `promoted` AdsPromoted[]
    - `id` string, required
    - `name` string
    - `type` 'PAGE_ID' | 'APP_ID' | 'STORE_URL' | 'PIXEL_ID' | 'CUSTOM_CONVERSION_ID' | 'CATALOG_ID' | 'PRODUCT_SET_ID' | 'PRIORITIZED_SET_ID' | 'EVENT_ID' | 'OFFER_ID' | 'LEAD_FORM_ID' | 'MESSAGING_CHANNEL_ID' | 'PRODUCT_ID' | 'TWEET_ID' | 'AD_GROUP_TYPE', required
    - `raw` object
  - `logo_creative_id` string
  - `raw` object

## Changes

- **2026-07-31** `963bcc74f9e3` — 3 warning, 3 info
  - added the new `CTV` enum value to the `ad_type` response property for the response status `200`
  - added the new `DOOH` enum value to the `ad_type` response property for the response status `200`
  - added the new `NATIVE` enum value to the `ad_type` response property for the response status `200`
  - added the new `CTV` enum value to the request property `ad_type`
  - …2 more
- **2026-07-26** `8f2437668567` — 6 info
  - added the new optional request property `advertiser_name`
  - added the new optional request property `logo_creative_id`
  - added the enum value `advertiser_name` to the property `items/` of the `query` request parameter `fields`
  - added the enum value `logo_creative_id` to the property `items/` of the `query` request parameter `fields`
  - …2 more

[Change history](https://skmtc.dev/unified/apis/unified-to-api/changes/ads/:connection_id/ad/:id/patch.md)

---

[API](https://skmtc.dev/unified/apis/unified-to-api.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unified/unified-to-api/revisions/45664a7696ac/schema)