---
title: "Changes to Update an Ad Group"
method: PATCH
path: "/ad_groups/{id}"
---

# Changes to Update an Ad Group

`PATCH /ad_groups/{id}`

> Every recorded change to this endpoint, newest first.
> 74 revisions in range; 1 not diffed.

## Timeline

Changed in 12 of 74 revisions.

- **2026-09-24** `7fcefabddb0a` — 1 warning, 3 info
- **2026-09-23** `140d015b9966` — 1 warning
- **2026-09-21** `ac2b9b1c6a00` — 5 info
- **2026-08-27** `16c82685be35` — 2 info
- **2026-08-20** `6a23760847c8` — 10 info
- **2026-08-15** `c301132dbfd7` — 1 warning
- **2026-08-14** `a84d4905fdbb` — 1 breaking, 1 info
- **2026-08-12** `ae20b30817de` — 4 warning, 4 info
- **2026-08-06** `a602de67ab25` — 1 breaking
- **2026-07-31** `099fdc3be422` — 6 warning
- **2026-07-26** `60bbb4a6ffbc` — 13 breaking, 25 warning, 57 info
- **2026-07-14** `3a06a605784b` — 2 info

## Changes

- **2026-09-24** `7fcefabddb0a` — 1 warning, 3 info
  - added the new `google` enum value to the `platform` response property for the response status `200`
  - added the new optional request property `budget_amount_local`
  - added the required property `budget_amount_local` to the response with the `200` status
  - added the required property `budget_currency` to the response with the `200` status
- **2026-09-23** `140d015b9966` — 1 warning
  - added the new `in_appeal` enum value to the `delivery_status` response property for the response status `200`
- **2026-09-21** `ac2b9b1c6a00` — 5 info
  - added the new optional request property `regions/exclude/custom_locations/items/country_code`
  - added the new optional request property `regions/include/custom_locations/items/country_code`
  - added the optional property `regions/exclude/custom_locations/items/country_code` to the response with the `200` status
  - added the optional property `regions/include/custom_locations/items/country_code` to the response with the `200` status
  - added the required property `platform` to the response with the `200` status
- **2026-08-27** `16c82685be35` — 2 info
  - the response property `conversion_event` became required for the status `200`
  - added the required property `link_clicks` to the response with the `200` status
- **2026-08-20** `6a23760847c8` — 10 info
  - added the new optional request property `detailed_targeting/behaviors/items/behavior_type`
  - added the new optional request property `detailed_targeting/behaviors/items/period`
  - added the optional property `detailed_targeting/behaviors/items/behavior_type` to the response with the `200` status
  - added the optional property `detailed_targeting/behaviors/items/period` to the response with the `200` status
  - the response property `detailed_targeting` became required for the status `200`
  - the response property `devices` became required for the status `200`
  - the response property `frequency_cap` became required for the status `200`
  - the response property `languages` became required for the status `200`
  - the response property `placements` became required for the status `200`
  - the response property `regions` became required for the status `200`
- **2026-08-15** `c301132dbfd7` — 1 warning
  - added the new `messaging_conversation` enum value to the `result_event` response property for the response status `200`
- **2026-08-14** `a84d4905fdbb` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2` from the `placements` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `placements` request property `anyOf` list
- **2026-08-12** `ae20b30817de` — 4 warning, 4 info
  - added the new `education_majors` enum value to the `detailed_targeting/demographics/items/type` response property for the response status `200`
  - added the new `education_schools` enum value to the `detailed_targeting/demographics/items/type` response property for the response status `200`
  - added the new `work_employers` enum value to the `detailed_targeting/demographics/items/type` response property for the response status `200`
  - added the new `work_positions` enum value to the `detailed_targeting/demographics/items/type` response property for the response status `200`
  - added the new `education_majors` enum value to the request property `detailed_targeting/demographics/items/type`
  - added the new `education_schools` enum value to the request property `detailed_targeting/demographics/items/type`
  - added the new `work_employers` enum value to the request property `detailed_targeting/demographics/items/type`
  - added the new `work_positions` enum value to the request property `detailed_targeting/demographics/items/type`
- **2026-08-06** `a602de67ab25` — 1 breaking
  - removed the enum value `thruplay` of the request property `optimization_goal`
- **2026-07-31** `099fdc3be422` — 6 warning
  - added the new `audience_network` enum value to the `placements/items/platform` response property for the response status `200`
  - added the new `facebook` enum value to the `placements/items/platform` response property for the response status `200`
  - added the new `instagram` enum value to the `placements/items/platform` response property for the response status `200`
  - added the new `messenger` enum value to the `placements/items/platform` response property for the response status `200`
  - added the new `threads` enum value to the `placements/items/platform` response property for the response status `200`
  - added the new `whatsapp` enum value to the `placements/items/platform` response property for the response status `200`
- **2026-07-26** `60bbb4a6ffbc` — 13 breaking, 25 warning, 57 info
  - request property `optimization_goal` was restricted to a list of enum values
  - the response property `conversion_event` became optional for the status `200`
  - the response property `conversion_location` became optional for the status `200`
  - the response property `devices` became optional for the status `200`
  - the response property `dynamic_creative` became optional for the status `200`
  - the response property `frequency_cap` became optional for the status `200`
  - the response property `languages` became optional for the status `200`
  - the response property `message_apps` became optional for the status `200`
  - the response property `minimum_daily_spend` became optional for the status `200`
  - the response property `placements` became optional for the status `200`
  - the response property `regions` became optional for the status `200`
  - added `#/components/schemas/AdGroupFrequencyCap, subschema #2` to the `frequency_cap` response property `oneOf` list for the response status `200`
  - the `frequency_cap` response's property type changed from `object, null` to no type for status `200`
  - added the new `ad_recall_lift` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `conversations` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `conversions` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `duplicating` enum value to the `status` response property for the response status `200`
  - added the new `engagement` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `event_responses` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `impressions` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `instagram` enum value to the `message_apps/items/` response property for the response status `200`
  - added the new `instagram_and_facebook` enum value to the `conversion_location` response property for the response status `200`
  - added the new `instagram_profile` enum value to the `conversion_location` response property for the response status `200`
  - added the new `landing_page_views` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `lead_generation` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `link_clicks` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `messenger` enum value to the `message_apps/items/` response property for the response status `200`
  - added the new `page_likes` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `profile_and_page_engagement` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `quality_lead` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `reach` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `reminders_set` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `social_profile` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `two_second_views` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `undefined` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `value` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `video_views` enum value to the `optimization_goal` response property for the response status `200`
  - added the new `whatsapp` enum value to the `message_apps/items/` response property for the response status `200`
  - added the new optional request property `audiences/exclude`
  - added the new optional request property `audiences/include`
  - …55 more
- **2026-07-14** `3a06a605784b` — 2 info
  - added the required property `custom_event_counts` to the response with the `200` status
  - added the required property `results` to the response with the `200` status

---

[Operation](https://skmtc.dev/whop/apis/whop-api/docs/ad_groups/:id/patch.md) · [API](https://skmtc.dev/whop/apis/whop-api.md) · [Page](https://skmtc.dev/whop/apis/whop-api/changes/ad_groups/:id/patch)
