whop_sdk 0.0.39 → 0.0.41

data/lib/whop_sdk/resources/ad_campaigns.rb

@@ -2,50 +2,118 @@
 
 module WhopSDK
   module Resources
-    # Ad campaigns
+    # An Ad Campaign is the top-level container for paid ads on an ad network. It sets
+    # the platform, objective, and budget strategy shared by its
+    # [ad groups](/api-reference/beta/ad-groups/ad-group) and ads.
+    #
+    # Use the Ad Campaigns API to create campaigns, list campaigns for an account,
+    # retrieve or update campaign settings, and pause or resume campaign delivery.
     class AdCampaigns
-      # Retrieves a single ad campaign by its unique identifier.
+      # Some parameter documentations has been truncated, see
+      # {WhopSDK::Models::AdCampaignCreateParams} for more details.
+      #
+      # Creates an ad campaign for an account.
+      #
+      # @overload create(objective:, platform:, title:, account_id: nil, bid_type: nil, budget_amount: nil, budget_optimization: nil, budget_type: nil, desired_cost_per_result: nil, ends_at: nil, special_ad_categories: nil, starts_at: nil, request_options: {})
+      #
+      # @param objective [Symbol, WhopSDK::Models::AdCampaignCreateParams::Objective] The goal the campaign optimizes toward.
+      #
+      # @param platform [Symbol, WhopSDK::Models::AdCampaignCreateParams::Platform] The ad network the campaign runs on.
+      #
+      # @param title [String] The title of the campaign.
+      #
+      # @param account_id [String] The account to create the campaign under. Defaults to the account-scoped key's o
       #
-      # Required permissions:
+      # @param bid_type [Symbol, WhopSDK::Models::AdCampaignCreateParams::BidType] CBO bid strategy: minimum_cost (lowest cost), average_target (cost cap), or maxi
       #
-      # - `ad_campaign:basic:read`
+      # @param budget_amount [Float] The campaign budget, in USD. Required for CBO (budget_optimization: ad_campaign)
       #
-      # @overload retrieve(id, request_options: {})
+      # @param budget_optimization [Symbol, WhopSDK::Models::AdCampaignCreateParams::BudgetOptimization] Which level owns the budget — the campaign (CBO) or each ad group (ABO). Default
       #
-      # @param id [String] The unique identifier of the ad campaign.
+      # @param budget_type [Symbol, WhopSDK::Models::AdCampaignCreateParams::BudgetType] Whether the budget is spent per day or over the campaign's lifetime. Defaults to
+      #
+      # @param desired_cost_per_result [Float] Target/cap cost per result in USD for average_target / maximum_target bidding. C
+      #
+      # @param ends_at [String] Campaign schedule end (ISO 8601). CBO only.
+      #
+      # @param special_ad_categories [Array<Symbol, WhopSDK::Models::AdCampaignCreateParams::SpecialAdCategory>] Regulated categories the campaign falls under. Ads in these categories are subje
+      #
+      # @param starts_at [String] Campaign schedule start (ISO 8601). CBO only.
       #
       # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [WhopSDK::Models::AdCampaignRetrieveResponse]
+      # @return [WhopSDK::Models::AdCampaign]
+      #
+      # @see WhopSDK::Models::AdCampaignCreateParams
+      def create(params)
+        parsed, options = WhopSDK::AdCampaignCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "ad_campaigns",
+          body: parsed,
+          model: WhopSDK::AdCampaign,
+          options: options
+        )
+      end
+
+      # Retrieves a single ad campaign with stats over the requested window.
+      #
+      # @overload retrieve(id, stats_from: nil, stats_to: nil, time_zone: nil, request_options: {})
+      #
+      # @param id [String] The ad campaign ID.
+      #
+      # @param stats_from [String] Start of the stats window.
+      #
+      # @param stats_to [String] End of the stats window.
+      #
+      # @param time_zone [String] IANA timezone the stats window is interpreted in. Defaults to UTC.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::AdCampaign]
       #
       # @see WhopSDK::Models::AdCampaignRetrieveParams
       def retrieve(id, params = {})
+        parsed, options = WhopSDK::AdCampaignRetrieveParams.dump_request(params)
+        query = WhopSDK::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["ad_campaigns/%1$s", id],
-          model: WhopSDK::Models::AdCampaignRetrieveResponse,
-          options: params[:request_options]
+          query: query,
+          model: WhopSDK::AdCampaign,
+          options: options
         )
       end
 
       # Some parameter documentations has been truncated, see
       # {WhopSDK::Models::AdCampaignUpdateParams} for more details.
       #
-      # Updates an ad campaign synchronously.
+      # Updates an ad campaign's editable fields (title, budget, schedule, bid strategy,
+      # and — before launch — budget optimization), and launches a draft campaign by
+      # setting status to active. Objective, budget type, special ad categories and
+      # desired cost per result are fixed at creation and cannot be changed.
+      #
+      # @overload update(id, bid_type: nil, budget_amount: nil, budget_optimization: nil, ends_at: nil, starts_at: nil, status: nil, title: nil, request_options: {})
+      #
+      # @param id [String] The ad campaign ID.
       #
-      # Required permissions:
+      # @param bid_type [Symbol, WhopSDK::Models::AdCampaignUpdateParams::BidType] CBO bid strategy: minimum_cost (lowest cost), average_target (cost cap), or maxi
       #
-      # - `ad_campaign:update`
+      # @param budget_amount [Float] The campaign budget, in the account's currency. Interpreted as daily or lifetime
       #
-      # @overload update(id, budget: nil, request_options: {})
+      # @param budget_optimization [Symbol, WhopSDK::Models::AdCampaignUpdateParams::BudgetOptimization] Which level owns the budget — the campaign (CBO) or each ad group (ABO). Only ch
       #
-      # @param id [String] The unique identifier of the ad campaign to update.
+      # @param ends_at [String] Campaign schedule end (ISO 8601). CBO only.
       #
-      # @param budget [Float, nil] The campaign budget in dollars. The interpretation (daily or lifetime) follows t
+      # @param starts_at [String] Campaign schedule start (ISO 8601). CBO only.
+      #
+      # @param status [Symbol, WhopSDK::Models::AdCampaignUpdateParams::Status] Set to active to launch a draft campaign (moderates and pushes it live). Live-ca
+      #
+      # @param title [String] The name of the campaign.
       #
       # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [WhopSDK::Models::AdCampaignUpdateResponse]
+      # @return [WhopSDK::Models::AdCampaign]
       #
       # @see WhopSDK::Models::AdCampaignUpdateParams
       def update(id, params = {})
@@ -54,44 +122,52 @@ module WhopSDK
           method: :patch,
           path: ["ad_campaigns/%1$s", id],
           body: parsed,
-          model: WhopSDK::Models::AdCampaignUpdateResponse,
+          model: WhopSDK::AdCampaign,
           options: options
         )
       end
 
-      # Returns a paginated list of ad campaigns for a company, with optional filtering
-      # by status, and creation date.
+      # Some parameter documentations has been truncated, see
+      # {WhopSDK::Models::AdCampaignListParams} for more details.
+      #
+      # Lists the ad campaigns for an account, with stats over the requested window.
+      #
+      # @overload list(account_id: nil, after: nil, before: nil, created_after: nil, created_before: nil, direction: nil, first: nil, last: nil, order: nil, query: nil, stats_from: nil, stats_to: nil, status: nil, time_zone: nil, request_options: {})
+      #
+      # @param account_id [String] The account the campaigns belong to. Defaults to the account-scoped key's own ac
       #
-      # Required permissions:
+      # @param after [String] Cursor to fetch the page after (from page_info.end_cursor).
       #
-      # - `ad_campaign:basic:read`
+      # @param before [String] Cursor to fetch the page before (from page_info.start_cursor).
       #
-      # @overload list(company_id:, after: nil, before: nil, created_after: nil, created_before: nil, first: nil, last: nil, query: nil, status: nil, request_options: {})
+      # @param created_after [String] Only return campaigns created after this timestamp.
       #
-      # @param company_id [String] The unique identifier of the company to list ad campaigns for.
+      # @param created_before [String] Only return campaigns created before this timestamp.
       #
-      # @param after [String, nil] Returns the elements in the list that come after the specified cursor.
+      # @param direction [Symbol, WhopSDK::Models::AdCampaignListParams::Direction] The sort direction. Defaults to desc.
       #
-      # @param before [String, nil] Returns the elements in the list that come before the specified cursor.
+      # @param first [Integer] The number of campaigns to return.
       #
-      # @param created_after [Time, nil] Only return ad campaigns created after this timestamp.
+      # @param last [Integer] The number of campaigns to return from the end of the range.
       #
-      # @param created_before [Time, nil] Only return ad campaigns created before this timestamp.
+      # @param order [Symbol, WhopSDK::Models::AdCampaignListParams::Order] The field to sort by. Defaults to created_at. Stat columns (spend, impressions,
       #
-      # @param first [Integer, nil] Returns the first _n_ elements from the list.
+      # @param query [String] Filter campaigns by a title or ID substring.
       #
-      # @param last [Integer, nil] Returns the last _n_ elements from the list.
+      # @param stats_from [String] Start of the stats window. Defaults to all-time.
       #
-      # @param query [String, nil] Case-insensitive substring match against the campaign title.
+      # @param stats_to [String] End of the stats window. Defaults to now.
       #
-      # @param status [Symbol, WhopSDK::Models::AdCampaignListParams::Status, nil] The status of an ad campaign.
+      # @param status [Symbol, WhopSDK::Models::AdCampaignListParams::Status] Only return campaigns with this status.
+      #
+      # @param time_zone [String] IANA timezone (e.g. America/New_York) the stats window is interpreted in. Bare s
       #
       # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [WhopSDK::Internal::CursorPage<WhopSDK::Models::AdCampaignListResponse>]
+      # @return [WhopSDK::Internal::CursorPage<WhopSDK::Models::AdCampaign>]
       #
       # @see WhopSDK::Models::AdCampaignListParams
-      def list(params)
+      def list(params = {})
         parsed, options = WhopSDK::AdCampaignListParams.dump_request(params)
         query = WhopSDK::Internal::Util.encode_query_params(parsed)
         @client.request(
@@ -99,55 +175,68 @@ module WhopSDK
           path: "ad_campaigns",
           query: query,
           page: WhopSDK::Internal::CursorPage,
-          model: WhopSDK::Models::AdCampaignListResponse,
+          model: WhopSDK::AdCampaign,
           options: options
         )
       end
 
-      # Pauses an ad campaign, optionally until a specific date.
+      # Deletes an ad campaign and archives it on the ad platform (cascades to ad groups
+      # and ads). Returns true on success.
+      #
+      # @overload delete(id, request_options: {})
       #
-      # Required permissions:
+      # @param id [String] The ad campaign ID.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # - `ad_campaign:update`
+      # @return [Boolean]
+      #
+      # @see WhopSDK::Models::AdCampaignDeleteParams
+      def delete(id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["ad_campaigns/%1$s", id],
+          model: WhopSDK::Internal::Type::Boolean,
+          options: params[:request_options]
+        )
+      end
+
+      # Pauses an active ad campaign.
       #
       # @overload pause(id, request_options: {})
       #
-      # @param id [String] The unique identifier of the ad campaign to pause.
+      # @param id [String] The ad campaign ID.
       #
       # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [WhopSDK::Models::AdCampaignPauseResponse]
+      # @return [WhopSDK::Models::AdCampaign]
       #
       # @see WhopSDK::Models::AdCampaignPauseParams
       def pause(id, params = {})
         @client.request(
           method: :post,
           path: ["ad_campaigns/%1$s/pause", id],
-          model: WhopSDK::Models::AdCampaignPauseResponse,
+          model: WhopSDK::AdCampaign,
           options: params[:request_options]
         )
       end
 
       # Resumes a paused ad campaign.
       #
-      # Required permissions:
-      #
-      # - `ad_campaign:update`
-      #
       # @overload unpause(id, request_options: {})
       #
-      # @param id [String] The unique identifier of the ad campaign to unpause.
+      # @param id [String] The ad campaign ID.
       #
       # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [WhopSDK::Models::AdCampaignUnpauseResponse]
+      # @return [WhopSDK::Models::AdCampaign]
       #
       # @see WhopSDK::Models::AdCampaignUnpauseParams
       def unpause(id, params = {})
         @client.request(
           method: :post,
           path: ["ad_campaigns/%1$s/unpause", id],
-          model: WhopSDK::Models::AdCampaignUnpauseResponse,
+          model: WhopSDK::AdCampaign,
           options: params[:request_options]
         )
       end

data/lib/whop_sdk/resources/ad_groups.rb

@@ -2,60 +2,163 @@
 
 module WhopSDK
   module Resources
-    # Ad groups
+    # An Ad Group sits inside an
+    # [ad campaign](/api-reference/beta/ad-campaigns/ad-campaign) and controls
+    # delivery for [ads](/api-reference/beta/ads/ad). It sets the audience,
+    # placements, schedule, budget, and optimization goal for its ads.
+    #
+    # Use the Ad Groups API to create ad groups in campaigns, list or retrieve
+    # targeting and delivery settings, update budgets or targeting, delete groups that
+    # should stop running, and pause or resume delivery.
     class AdGroups
-      # Retrieves a single ad group by its unique identifier.
+      # Some parameter documentations has been truncated, see
+      # {WhopSDK::Models::AdGroupCreateParams} for more details.
       #
-      # Required permissions:
+      # Creates an ad group (ad set) in a campaign.
       #
-      # - `ad_campaign:basic:read`
+      # @overload create(ad_campaign_id:, audiences: nil, bid_type: nil, budget_amount: nil, budget_type: nil, conversion_event: nil, conversion_location: nil, demographics: nil, desired_cost_per_result: nil, devices: nil, dynamic_creative: nil, ends_at: nil, frequency_cap: nil, languages: nil, message_apps: nil, minimum_daily_spend: nil, optimization_goal: nil, placements: nil, regions: nil, starts_at: nil, status: nil, title: nil, request_options: {})
       #
-      # @overload retrieve(id, request_options: {})
+      # @param ad_campaign_id [String] The ad campaign to create the ad group in.
       #
-      # @param id [String] The unique identifier of the ad group.
+      # @param audiences [Object] Saved-audience targeting: { include, exclude } arrays of audience IDs. Incompati
+      #
+      # @param bid_type [Symbol, WhopSDK::Models::AdGroupCreateParams::BidType] Bid strategy.
+      #
+      # @param budget_amount [Float] Ad-set budget in dollars (ABO only; omit under CBO).
+      #
+      # @param budget_type [Symbol, WhopSDK::Models::AdGroupCreateParams::BudgetType] Whether the budget is daily or lifetime.
+      #
+      # @param conversion_event [Symbol, String, WhopSDK::Models::AdGroupCreateParams::ConversionEvent, nil] The pixel event optimized for. A standard event, or any custom pixel event name.
+      #
+      # @param conversion_location [Symbol, WhopSDK::Models::AdGroupCreateParams::ConversionLocation] Where results happen: website (conversions), profile (IG/FB engagement), messagi
+      #
+      # @param demographics [Object] Demographic targeting: { automatic, minimum_age, maximum_age, gender }.
+      #
+      # @param desired_cost_per_result [Float] Target/cap cost for average_target / maximum_target.
+      #
+      # @param devices [Object] Device targeting: { platforms, operating_systems: [{ os, minimum_version }] }.
+      #
+      # @param dynamic_creative [Boolean] Run Meta dynamic (Advantage+) creative for this ad set. Set at creation; immutab
+      #
+      # @param ends_at [String] Schedule end, ISO 8601.
+      #
+      # @param frequency_cap [Object] { maximum_impressions, per_days } — only valid for reach optimization.
+      #
+      # @param languages [Array<String>] Languages to target as ISO 639 codes (e.g. en, es). Empty/omitted = all language
+      #
+      # @param message_apps [Array<Symbol, WhopSDK::Models::AdGroupCreateParams::MessageApp>] Required when conversion_location is messaging: which apps to message on. Combin
+      #
+      # @param minimum_daily_spend [Float] Daily spend floor within the budget.
+      #
+      # @param optimization_goal [String] What the ad group optimizes for (e.g. conversions, link_clicks, reach).
+      #
+      # @param placements [Object] 'automatic' (Advantage+) or a list of { platform, positions }. Omit positions to
+      #
+      # @param regions [Object] Geo targeting: { include / exclude: { countries (ISO 3166-1), regions (states/pr
+      #
+      # @param starts_at [String] Schedule start, ISO 8601.
+      #
+      # @param status [Symbol, WhopSDK::Models::AdGroupCreateParams::Status] Initial status (default: active).
+      #
+      # @param title [String] The display name of the ad group.
       #
       # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [WhopSDK::Models::AdGroupRetrieveResponse]
+      # @return [WhopSDK::Models::AdGroup]
+      #
+      # @see WhopSDK::Models::AdGroupCreateParams
+      def create(params)
+        parsed, options = WhopSDK::AdGroupCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "ad_groups",
+          body: parsed,
+          model: WhopSDK::AdGroup,
+          options: options
+        )
+      end
+
+      # Retrieves a single ad group.
+      #
+      # @overload retrieve(id, stats_from: nil, stats_to: nil, time_zone: nil, request_options: {})
+      #
+      # @param id [String] The ad group ID.
+      #
+      # @param stats_from [String] Start of the stats window.
+      #
+      # @param stats_to [String] End of the stats window.
+      #
+      # @param time_zone [String] IANA timezone the stats window is interpreted in. Defaults to UTC.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::AdGroup]
       #
       # @see WhopSDK::Models::AdGroupRetrieveParams
       def retrieve(id, params = {})
+        parsed, options = WhopSDK::AdGroupRetrieveParams.dump_request(params)
+        query = WhopSDK::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["ad_groups/%1$s", id],
-          model: WhopSDK::Models::AdGroupRetrieveResponse,
-          options: params[:request_options]
+          query: query,
+          model: WhopSDK::AdGroup,
+          options: options
         )
       end
 
-      # Updates an existing ad group.
+      # Some parameter documentations has been truncated, see
+      # {WhopSDK::Models::AdGroupUpdateParams} for more details.
       #
-      # Required permissions:
+      # Updates an ad group's editable fields. Only the keys you send are changed.
       #
-      # - `ad_campaign:update`
-      # - `ad_campaign:basic:read`
+      # @overload update(id, audiences: nil, bid_type: nil, budget_amount: nil, budget_type: nil, conversion_event: nil, conversion_location: nil, demographics: nil, desired_cost_per_result: nil, devices: nil, ends_at: nil, frequency_cap: nil, languages: nil, message_apps: nil, minimum_daily_spend: nil, optimization_goal: nil, placements: nil, regions: nil, starts_at: nil, status: nil, title: nil, request_options: {})
       #
-      # @overload update(id, budget: nil, budget_type: nil, config: nil, daily_budget: nil, name: nil, platform_config: nil, status: nil, request_options: {})
+      # @param id [String] The ad group ID.
       #
-      # @param id [String] The unique identifier of the ad group to update.
+      # @param audiences [Object] Saved-audience targeting: { include, exclude } arrays of audience IDs. Incompati
       #
-      # @param budget [Float, nil] Budget amount in dollars.
+      # @param bid_type [Symbol, WhopSDK::Models::AdGroupUpdateParams::BidType] Bid strategy.
       #
-      # @param budget_type [Symbol, WhopSDK::Models::AdGroupUpdateParams::BudgetType, nil] The budget type for an ad campaign or ad group.
+      # @param budget_amount [Float] Ad-set budget in dollars (ABO only; omit under CBO).
       #
-      # @param config [WhopSDK::Models::AdGroupUpdateParams::Config, nil] Unified ad group configuration (bidding, optimization, targeting).
+      # @param budget_type [Symbol, WhopSDK::Models::AdGroupUpdateParams::BudgetType] Whether the budget is daily or lifetime.
       #
-      # @param daily_budget [Float, nil] Daily budget in dollars.
+      # @param conversion_event [Symbol, String, WhopSDK::Models::AdGroupUpdateParams::ConversionEvent, nil] The pixel event optimized for. A standard event, or any custom pixel event name.
       #
-      # @param name [String, nil] Human-readable ad group name.
+      # @param conversion_location [Symbol, WhopSDK::Models::AdGroupUpdateParams::ConversionLocation] Where results happen: website (conversions), profile (IG/FB engagement), messagi
       #
-      # @param platform_config [WhopSDK::Models::AdGroupUpdateParams::PlatformConfig, nil] Platform-specific ad group configuration.
+      # @param demographics [Object] Demographic targeting: { automatic, minimum_age, maximum_age, gender }.
       #
-      # @param status [Symbol, WhopSDK::Models::AdGroupUpdateParams::Status, nil] The status of an external ad group.
+      # @param desired_cost_per_result [Float] Target/cap cost for average_target / maximum_target.
+      #
+      # @param devices [Object] Device targeting: { platforms, operating_systems: [{ os, minimum_version }] }.
+      #
+      # @param ends_at [String] Schedule end, ISO 8601.
+      #
+      # @param frequency_cap [Object] { maximum_impressions, per_days } — only valid for reach optimization.
+      #
+      # @param languages [Array<String>] Languages to target as ISO 639 codes (e.g. en, es). Empty/omitted = all language
+      #
+      # @param message_apps [Array<Symbol, WhopSDK::Models::AdGroupUpdateParams::MessageApp>] Required when conversion_location is messaging: which apps to message on. Combin
+      #
+      # @param minimum_daily_spend [Float] Daily spend floor within the budget.
+      #
+      # @param optimization_goal [String] What the ad group optimizes for (e.g. conversions, link_clicks, reach).
+      #
+      # @param placements [Object] 'automatic' (Advantage+) or a list of { platform, positions }. Omit positions to
+      #
+      # @param regions [Object] Geo targeting: { include / exclude: { countries (ISO 3166-1), regions (states/pr
+      #
+      # @param starts_at [String] Schedule start, ISO 8601.
+      #
+      # @param status [Symbol, WhopSDK::Models::AdGroupUpdateParams::Status] Initial status (default: active).
+      #
+      # @param title [String] The display name of the ad group.
       #
       # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [WhopSDK::Models::AdGroupUpdateResponse]
+      # @return [WhopSDK::Models::AdGroup]
       #
       # @see WhopSDK::Models::AdGroupUpdateParams
       def update(id, params = {})
@@ -64,43 +167,51 @@ module WhopSDK
           method: :patch,
           path: ["ad_groups/%1$s", id],
           body: parsed,
-          model: WhopSDK::Models::AdGroupUpdateResponse,
+          model: WhopSDK::AdGroup,
           options: options
         )
       end
 
-      # Returns a paginated list of ad groups scoped by campaign or company, with
-      # optional filtering by status and creation date.
+      # Some parameter documentations has been truncated, see
+      # {WhopSDK::Models::AdGroupListParams} for more details.
+      #
+      # Lists ad groups for the account, newest first.
+      #
+      # @overload list(account_id: nil, ad_campaign_id: nil, after: nil, before: nil, created_after: nil, created_before: nil, direction: nil, first: nil, last: nil, order: nil, query: nil, stats_from: nil, stats_to: nil, status: nil, time_zone: nil, request_options: {})
+      #
+      # @param account_id [String] Account whose ad groups to list. Defaults to the authenticated account.
       #
-      # Required permissions:
+      # @param ad_campaign_id [String] Filter to ad groups in this campaign.
       #
-      # - `ad_campaign:basic:read`
+      # @param after [String] Cursor to fetch the page after (from page_info.end_cursor).
       #
-      # @overload list(after: nil, before: nil, campaign_id: nil, company_id: nil, created_after: nil, created_before: nil, first: nil, last: nil, query: nil, status: nil, request_options: {})
+      # @param before [String] Cursor to fetch the page before (from page_info.start_cursor).
       #
-      # @param after [String, nil] Returns the elements in the list that come after the specified cursor.
+      # @param created_after [String] Only return ad groups created after this timestamp.
       #
-      # @param before [String, nil] Returns the elements in the list that come before the specified cursor.
+      # @param created_before [String] Only return ad groups created before this timestamp.
       #
-      # @param campaign_id [String, nil] Filter by campaign. Provide exactly one of campaign_id or company_id.
+      # @param direction [Symbol, WhopSDK::Models::AdGroupListParams::Direction] The sort direction. Defaults to desc.
       #
-      # @param company_id [String, nil] Filter by company. Provide exactly one of campaign_id or company_id.
+      # @param first [Integer] The number of ad groups to return.
       #
-      # @param created_after [Time, nil] Only return ad groups created after this timestamp.
+      # @param last [Integer] The number of ad groups to return from the end of the range.
       #
-      # @param created_before [Time, nil] Only return ad groups created before this timestamp.
+      # @param order [Symbol, WhopSDK::Models::AdGroupListParams::Order] The field to sort by. Defaults to created_at. Stat columns (spend, impressions,
       #
-      # @param first [Integer, nil] Returns the first _n_ elements from the list.
+      # @param query [String] Filter ad groups by a title or ID substring.
       #
-      # @param last [Integer, nil] Returns the last _n_ elements from the list.
+      # @param stats_from [String] Start of the stats window. Defaults to all-time.
       #
-      # @param query [String, nil] Case-insensitive substring match against the ad group name.
+      # @param stats_to [String] End of the stats window. Defaults to now.
       #
-      # @param status [Symbol, WhopSDK::Models::AdGroupListParams::Status, nil] The status of an external ad group.
+      # @param status [String] Filter to a status (active, paused, in_review, rejected).
+      #
+      # @param time_zone [String] IANA timezone (e.g. America/New_York) the stats window is interpreted in. Bare s
       #
       # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [WhopSDK::Internal::CursorPage<WhopSDK::Models::AdGroupListResponse>]
+      # @return [WhopSDK::Internal::CursorPage<WhopSDK::Models::AdGroup>]
       #
       # @see WhopSDK::Models::AdGroupListParams
       def list(params = {})
@@ -111,20 +222,16 @@ module WhopSDK
           path: "ad_groups",
           query: query,
           page: WhopSDK::Internal::CursorPage,
-          model: WhopSDK::Models::AdGroupListResponse,
+          model: WhopSDK::AdGroup,
           options: options
         )
       end
 
-      # Soft-deletes an ad group.
-      #
-      # Required permissions:
-      #
-      # - `ad_campaign:update`
+      # Deletes an ad group. Returns true on success.
       #
       # @overload delete(id, request_options: {})
       #
-      # @param id [String] The unique identifier of the ad group to delete.
+      # @param id [String] The ad group ID.
       #
       # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -140,6 +247,46 @@ module WhopSDK
         )
       end
 
+      # Pauses delivery of an ad group.
+      #
+      # @overload pause(id, request_options: {})
+      #
+      # @param id [String] The ad group ID.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::AdGroup]
+      #
+      # @see WhopSDK::Models::AdGroupPauseParams
+      def pause(id, params = {})
+        @client.request(
+          method: :post,
+          path: ["ad_groups/%1$s/pause", id],
+          model: WhopSDK::AdGroup,
+          options: params[:request_options]
+        )
+      end
+
+      # Resumes delivery of a paused ad group.
+      #
+      # @overload unpause(id, request_options: {})
+      #
+      # @param id [String] The ad group ID.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::AdGroup]
+      #
+      # @see WhopSDK::Models::AdGroupUnpauseParams
+      def unpause(id, params = {})
+        @client.request(
+          method: :post,
+          path: ["ad_groups/%1$s/unpause", id],
+          model: WhopSDK::AdGroup,
+          options: params[:request_options]
+        )
+      end
+
       # @api private
       #
       # @param client [WhopSDK::Client]