growsurf-ruby 0.8.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ea326d15c05d8c75b86335b99e152c1e269196cc3603ed96b38a11281509a26
-  data.tar.gz: ccc73ce7424bd230f00745bc08d843c5a1bcee077468c5ee5d01ee497578f9e2
+  metadata.gz: 3f01d0f2cb2534783b61dc721b1fde1d8f4465951558a08e474a2c0816b55785
+  data.tar.gz: bc309ac0246f6ee795ccb48487c37f366c3e04293cdc9f3fea0ef55c8a8576e0
 SHA512:
-  metadata.gz: 67581d38788ab7a27e22a1f5d010e6a85e152ded9d3f5ffd512c22dd2ac52df70452254fdb02a91b237ef416f27a5326df0240b4111ce2b67bd1f8606b64d00b
-  data.tar.gz: 05b6ad5c2614c5ba9647bd7b54874d2feeb720659f2ae7930252afc48781d100fe0edac724b2b5f7ef789f0a75851621c0b73de2c4226a3b7602515227627c5e
+  metadata.gz: bf7d990bbf244492889bdb83c07478bee329598a80eaf4bb48a9445fb322fcdd10fa1a7854a19c8f5dee29f4277d7a3a13c557f5329ebada1309ba7f7a299461
+  data.tar.gz: 4157fc3ebf661d9a92f4713b9f10d91f1f31f6d298449684c5f01946c85909eb3fbf02aefff7399282d7d9c81f124878543806cc307629752105c7156355c1cc

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [1.0.0](https://github.com/growsurf/growsurf-ruby/compare/v0.8.0...v1.0.0) (2026-07-03)
+
+
+### ⚠ BREAKING CHANGES
+
+* campaign create no longer accepts `options`, and campaign update no longer accepts the design / emails / options / notifications / installation config blobs — edit those via the new config sub-resources. Reward-config CRUD moved from /campaign/{id}/rewards to /campaign/{id}/reward-configs[/{campaignRewardId}].
+
+### Features
+
+* add campaign management endpoints; drop deprecated create/update config blobs ([c67a800](https://github.com/growsurf/growsurf-ruby/commit/c67a800670fe56394960e944f301ec068aeb50a9))
+
 ## [0.8.0](https://github.com/growsurf/growsurf-ruby/compare/v0.7.0...v0.8.0) (2026-07-01)
 
 

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "growsurf-ruby", "~> 0.8.0"
+gem "growsurf-ruby", "~> 1.0.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/growsurf_ruby/models/campaign/reward.rb

@@ -88,6 +88,12 @@ module GrowsurfRuby
         #   @return [Integer, nil]
         optional :order, Integer, nil?: true
 
+        # @!attribute referral_coupon_code
+        #   The coupon code delivered to the referred friend (double-sided rewards).
+        #
+        #   @return [String, nil]
+        optional :referral_coupon_code, String, api_name: :referralCouponCode, nil?: true
+
         # @!attribute referral_description
         #
         #   @return [String, nil]
@@ -100,7 +106,22 @@ module GrowsurfRuby
                  GrowsurfRuby::Internal::Type::Boolean,
                  api_name: :referredRewardUpfront
 
-        # @!method initialize(id:, is_unlimited:, metadata:, type:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, image_url: nil, limit: nil, limit_duration: nil, next_milestone_prefix: nil, next_milestone_suffix: nil, number_of_winners: nil, order: nil, referral_description: nil, referred_reward_upfront: nil)
+        # @!attribute referred_value
+        #   Tax valuation for the referred friend's side of a double-sided reward.
+        #
+        #   @return [GrowsurfRuby::Models::RewardTaxValuation, nil]
+        optional :referred_value,
+                 -> { GrowsurfRuby::RewardTaxValuation },
+                 api_name: :referredValue,
+                 nil?: true
+
+        # @!attribute value
+        #   Tax valuation for the reward (the referrer's side of a double-sided reward).
+        #
+        #   @return [GrowsurfRuby::Models::RewardTaxValuation, nil]
+        optional :value, -> { GrowsurfRuby::RewardTaxValuation }, nil?: true
+
+        # @!method initialize(id:, is_unlimited:, metadata:, type:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, image_url: nil, limit: nil, limit_duration: nil, next_milestone_prefix: nil, next_milestone_suffix: nil, number_of_winners: nil, order: nil, referral_coupon_code: nil, referral_description: nil, referred_reward_upfront: nil, referred_value: nil, value: nil)
         #   @param id [String]
         #
         #   @param is_unlimited [Boolean]
@@ -131,9 +152,15 @@ module GrowsurfRuby
         #
         #   @param order [Integer, nil]
         #
+        #   @param referral_coupon_code [String, nil] The coupon code delivered to the referred friend (double-sided rewards).
+        #
         #   @param referral_description [String, nil]
         #
         #   @param referred_reward_upfront [Boolean]
+        #
+        #   @param referred_value [GrowsurfRuby::Models::RewardTaxValuation, nil] Tax valuation for the referred friend's side of a double-sided reward.
+        #
+        #   @param value [GrowsurfRuby::Models::RewardTaxValuation, nil] Tax valuation for the reward (the referrer's side of a double-sided reward).
 
         # @see GrowsurfRuby::Models::Campaign::Reward#type
         module Type

data/lib/growsurf_ruby/models/campaign/reward_create_params.rb

@@ -110,12 +110,31 @@ module GrowsurfRuby
                  GrowsurfRuby::Internal::Type::Boolean,
                  api_name: :referredRewardUpfront
 
+        # @!attribute referred_value
+        #   Tax valuation for the referred friend's side of a double-sided reward.
+        #   Defaults to not tax-reportable (a purchase rebate).
+        #
+        #   @return [GrowsurfRuby::Models::RewardTaxValuation, nil]
+        optional :referred_value,
+                 -> { GrowsurfRuby::RewardTaxValuation },
+                 api_name: :referredValue
+
         # @!attribute title
         #
         #   @return [String, nil]
         optional :title, String
 
-        # @!method initialize(type:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, image_url: nil, is_active: nil, is_unlimited: nil, is_visible: nil, limit: nil, limit_duration: nil, metadata: nil, next_milestone_prefix: nil, next_milestone_suffix: nil, number_of_winners: nil, order: nil, referral_coupon_code: nil, referral_description: nil, referred_reward_upfront: nil, title: nil, request_options: {})
+        # @!attribute value
+        #   Tax valuation for the reward (the referrer's side of a double-sided reward).
+        #   Used by tax documentation / 1099 reporting.
+        #
+        #   @return [GrowsurfRuby::Models::RewardTaxValuation, nil]
+        optional :value, -> { GrowsurfRuby::RewardTaxValuation }
+
+        # @!method initialize(type:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, image_url: nil, is_active: nil, is_unlimited: nil, is_visible: nil, limit: nil, limit_duration: nil, metadata: nil, next_milestone_prefix: nil, next_milestone_suffix: nil, number_of_winners: nil, order: nil, referral_coupon_code: nil, referral_description: nil, referred_reward_upfront: nil, referred_value: nil, title: nil, value: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {GrowsurfRuby::Models::Campaign::RewardCreateParams} for more details.
+        #
         #   @param type [Symbol, GrowsurfRuby::Models::Campaign::RewardCreateParams::Type]
         #
         #   @param commission_structure [GrowsurfRuby::Models::CommissionStructure]
@@ -154,8 +173,12 @@ module GrowsurfRuby
         #
         #   @param referred_reward_upfront [Boolean]
         #
+        #   @param referred_value [GrowsurfRuby::Models::RewardTaxValuation] Tax valuation for the referred friend's side of a double-sided reward. Defaults
+        #
         #   @param title [String]
         #
+        #   @param value [GrowsurfRuby::Models::RewardTaxValuation] Tax valuation for the reward (the referrer's side of a double-sided reward). Use
+        #
         #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]
 
         # @see GrowsurfRuby::Models::Campaign::RewardCreateParams#type

data/lib/growsurf_ruby/models/campaign/reward_delete_params.rb

@@ -13,14 +13,14 @@ module GrowsurfRuby
         #   @return [String]
         required :id, String
 
-        # @!attribute reward_id
+        # @!attribute campaign_reward_id
         #
         #   @return [String]
-        required :reward_id, String
+        required :campaign_reward_id, String
 
-        # @!method initialize(id:, reward_id:, request_options: {})
+        # @!method initialize(id:, campaign_reward_id:, request_options: {})
         #   @param id [String]
-        #   @param reward_id [String]
+        #   @param campaign_reward_id [String]
         #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/growsurf_ruby/models/campaign/reward_update_params.rb

@@ -13,10 +13,10 @@ module GrowsurfRuby
         #   @return [String]
         required :id, String
 
-        # @!attribute reward_id
+        # @!attribute campaign_reward_id
         #
         #   @return [String]
-        required :reward_id, String
+        required :campaign_reward_id, String
 
         # @!attribute commission_structure
         #
@@ -115,15 +115,34 @@ module GrowsurfRuby
                  GrowsurfRuby::Internal::Type::Boolean,
                  api_name: :referredRewardUpfront
 
+        # @!attribute referred_value
+        #   Tax valuation for the referred friend's side of a double-sided reward.
+        #   Defaults to not tax-reportable (a purchase rebate).
+        #
+        #   @return [GrowsurfRuby::Models::RewardTaxValuation, nil]
+        optional :referred_value,
+                 -> { GrowsurfRuby::RewardTaxValuation },
+                 api_name: :referredValue
+
         # @!attribute title
         #
         #   @return [String, nil]
         optional :title, String
 
-        # @!method initialize(id:, reward_id:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, image_url: nil, is_active: nil, is_unlimited: nil, is_visible: nil, limit: nil, limit_duration: nil, metadata: nil, next_milestone_prefix: nil, next_milestone_suffix: nil, number_of_winners: nil, order: nil, referral_coupon_code: nil, referral_description: nil, referred_reward_upfront: nil, title: nil, request_options: {})
+        # @!attribute value
+        #   Tax valuation for the reward (the referrer's side of a double-sided reward).
+        #   Used by tax documentation / 1099 reporting.
+        #
+        #   @return [GrowsurfRuby::Models::RewardTaxValuation, nil]
+        optional :value, -> { GrowsurfRuby::RewardTaxValuation }
+
+        # @!method initialize(id:, campaign_reward_id:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, image_url: nil, is_active: nil, is_unlimited: nil, is_visible: nil, limit: nil, limit_duration: nil, metadata: nil, next_milestone_prefix: nil, next_milestone_suffix: nil, number_of_winners: nil, order: nil, referral_coupon_code: nil, referral_description: nil, referred_reward_upfront: nil, referred_value: nil, title: nil, value: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {GrowsurfRuby::Models::Campaign::RewardUpdateParams} for more details.
+        #
         #   @param id [String]
         #
-        #   @param reward_id [String]
+        #   @param campaign_reward_id [String]
         #
         #   @param commission_structure [GrowsurfRuby::Models::CommissionStructure]
         #
@@ -161,8 +180,12 @@ module GrowsurfRuby
         #
         #   @param referred_reward_upfront [Boolean]
         #
+        #   @param referred_value [GrowsurfRuby::Models::RewardTaxValuation] Tax valuation for the referred friend's side of a double-sided reward. Defaults
+        #
         #   @param title [String]
         #
+        #   @param value [GrowsurfRuby::Models::RewardTaxValuation] Tax valuation for the reward (the referrer's side of a double-sided reward). Use
+        #
         #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]
 
         # @see GrowsurfRuby::Models::Campaign::RewardUpdateParams#limit_duration

data/lib/growsurf_ruby/models/campaign.rb

@@ -156,6 +156,12 @@ module GrowsurfRuby
         #   @return [Integer, nil]
         optional :order, Integer, nil?: true
 
+        # @!attribute referral_coupon_code
+        #   The coupon code delivered to the referred friend (double-sided rewards).
+        #
+        #   @return [String, nil]
+        optional :referral_coupon_code, String, api_name: :referralCouponCode, nil?: true
+
         # @!attribute referral_description
         #
         #   @return [String, nil]
@@ -168,7 +174,22 @@ module GrowsurfRuby
                  GrowsurfRuby::Internal::Type::Boolean,
                  api_name: :referredRewardUpfront
 
-        # @!method initialize(id:, is_unlimited:, metadata:, type:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, image_url: nil, limit: nil, limit_duration: nil, next_milestone_prefix: nil, next_milestone_suffix: nil, number_of_winners: nil, order: nil, referral_description: nil, referred_reward_upfront: nil)
+        # @!attribute referred_value
+        #   Tax valuation for the referred friend's side of a double-sided reward.
+        #
+        #   @return [GrowsurfRuby::Models::RewardTaxValuation, nil]
+        optional :referred_value,
+                 -> { GrowsurfRuby::RewardTaxValuation },
+                 api_name: :referredValue,
+                 nil?: true
+
+        # @!attribute value
+        #   Tax valuation for the reward (the referrer's side of a double-sided reward).
+        #
+        #   @return [GrowsurfRuby::Models::RewardTaxValuation, nil]
+        optional :value, -> { GrowsurfRuby::RewardTaxValuation }, nil?: true
+
+        # @!method initialize(id:, is_unlimited:, metadata:, type:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, image_url: nil, limit: nil, limit_duration: nil, next_milestone_prefix: nil, next_milestone_suffix: nil, number_of_winners: nil, order: nil, referral_coupon_code: nil, referral_description: nil, referred_reward_upfront: nil, referred_value: nil, value: nil)
         #   @param id [String]
         #
         #   @param is_unlimited [Boolean]
@@ -199,9 +220,15 @@ module GrowsurfRuby
         #
         #   @param order [Integer, nil]
         #
+        #   @param referral_coupon_code [String, nil] The coupon code delivered to the referred friend (double-sided rewards).
+        #
         #   @param referral_description [String, nil]
         #
         #   @param referred_reward_upfront [Boolean]
+        #
+        #   @param referred_value [GrowsurfRuby::Models::RewardTaxValuation, nil] Tax valuation for the referred friend's side of a double-sided reward.
+        #
+        #   @param value [GrowsurfRuby::Models::RewardTaxValuation, nil] Tax valuation for the reward (the referrer's side of a double-sided reward).
 
         # @see GrowsurfRuby::Models::CampaignAPI::Reward#type
         module Type

data/lib/growsurf_ruby/models/campaign_create_params.rb

@@ -27,28 +27,18 @@ module GrowsurfRuby
       #   @return [String, nil]
       optional :currency_iso, String, api_name: :currencyISO
 
-      # @!attribute goal
-      #
-      #   @return [String, nil]
-      optional :goal, String
-
       # @!attribute name
       #
       #   @return [String, nil]
       optional :name, String
 
-      # @!attribute options
-      #
-      #   @return [Hash{Symbol=>Object}, nil]
-      optional :options, GrowsurfRuby::Internal::Type::HashOf[GrowsurfRuby::Internal::Type::Unknown]
-
       # @!attribute rewards
       #
       #   @return [Array<GrowsurfRuby::Models::Campaign::RewardCreateParams>, nil]
       optional :rewards,
                -> { GrowsurfRuby::Internal::Type::ArrayOf[GrowsurfRuby::Campaign::RewardCreateParams] }
 
-      # @!method initialize(type:, company_logo_image_url: nil, company_name: nil, currency_iso: nil, goal: nil, name: nil, options: nil, rewards: nil, request_options: {})
+      # @!method initialize(type:, company_logo_image_url: nil, company_name: nil, currency_iso: nil, name: nil, rewards: nil, request_options: {})
       #   @param type [Symbol, GrowsurfRuby::Models::CampaignCreateParams::Type]
       #
       #   @param company_logo_image_url [String]
@@ -57,12 +47,8 @@ module GrowsurfRuby
       #
       #   @param currency_iso [String]
       #
-      #   @param goal [String]
-      #
       #   @param name [String]
       #
-      #   @param options [Hash{Symbol=>Object}]
-      #
       #   @param rewards [Array<GrowsurfRuby::Models::Campaign::RewardCreateParams>]
       #
       #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]

data/lib/growsurf_ruby/models/campaign_update_params.rb

@@ -22,74 +22,25 @@ module GrowsurfRuby
       #   @return [String, nil]
       optional :company_name, String, api_name: :companyName
 
-      # @!attribute currency_iso
-      #
-      #   @return [String, nil]
-      optional :currency_iso, String, api_name: :currencyISO
-
-      # @!attribute design
-      #
-      #   @return [Hash{Symbol=>Object}, nil]
-      optional :design, GrowsurfRuby::Internal::Type::HashOf[GrowsurfRuby::Internal::Type::Unknown]
-
-      # @!attribute emails
-      #
-      #   @return [Hash{Symbol=>Object}, nil]
-      optional :emails, GrowsurfRuby::Internal::Type::HashOf[GrowsurfRuby::Internal::Type::Unknown]
-
-      # @!attribute goal
-      #
-      #   @return [String, nil]
-      optional :goal, String
-
-      # @!attribute installation
-      #
-      #   @return [Hash{Symbol=>Object}, nil]
-      optional :installation, GrowsurfRuby::Internal::Type::HashOf[GrowsurfRuby::Internal::Type::Unknown]
-
       # @!attribute name
       #
       #   @return [String, nil]
       optional :name, String
 
-      # @!attribute notifications
-      #
-      #   @return [Hash{Symbol=>Object}, nil]
-      optional :notifications, GrowsurfRuby::Internal::Type::HashOf[GrowsurfRuby::Internal::Type::Unknown]
-
-      # @!attribute options
-      #
-      #   @return [Hash{Symbol=>Object}, nil]
-      optional :options, GrowsurfRuby::Internal::Type::HashOf[GrowsurfRuby::Internal::Type::Unknown]
-
       # @!attribute status
       #
       #   @return [Symbol, GrowsurfRuby::Models::CampaignUpdateParams::Status, nil]
       optional :status, enum: -> { GrowsurfRuby::CampaignUpdateParams::Status }
 
-      # @!method initialize(id:, company_logo_image_url: nil, company_name: nil, currency_iso: nil, design: nil, emails: nil, goal: nil, installation: nil, name: nil, notifications: nil, options: nil, status: nil, request_options: {})
+      # @!method initialize(id:, company_logo_image_url: nil, company_name: nil, name: nil, status: nil, request_options: {})
       #   @param id [String]
       #
       #   @param company_logo_image_url [String]
       #
       #   @param company_name [String]
       #
-      #   @param currency_iso [String]
-      #
-      #   @param design [Hash{Symbol=>Object}]
-      #
-      #   @param emails [Hash{Symbol=>Object}]
-      #
-      #   @param goal [String]
-      #
-      #   @param installation [Hash{Symbol=>Object}]
-      #
       #   @param name [String]
       #
-      #   @param notifications [Hash{Symbol=>Object}]
-      #
-      #   @param options [Hash{Symbol=>Object}]
-      #
       #   @param status [Symbol, GrowsurfRuby::Models::CampaignUpdateParams::Status]
       #
       #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]

data/lib/growsurf_ruby/models/reward_tax_valuation.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Models
+    class RewardTaxValuation < GrowsurfRuby::Internal::Type::BaseModel
+      # @!attribute fair_market_value_usd
+      #   Manual fair-market value in USD (major units) used as the fallback when the
+      #   reward value cannot be resolved automatically. `null` = no manual value.
+      #
+      #   @return [Float, nil]
+      optional :fair_market_value_usd, Float, api_name: :fairMarketValueUSD, nil?: true
+
+      # @!attribute is_tax_reportable
+      #   Whether the reward's value counts toward 1099 thresholds/totals. `null` = use
+      #   the smart default for the reward's source.
+      #
+      #   @return [Boolean, nil]
+      optional :is_tax_reportable,
+               GrowsurfRuby::Internal::Type::Boolean,
+               api_name: :isTaxReportable,
+               nil?: true
+
+      # @!method initialize(fair_market_value_usd: nil, is_tax_reportable: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {GrowsurfRuby::Models::RewardTaxValuation} for more details.
+      #
+      #   Tax valuation settings for a reward. Only relevant when the program collects
+      #   tax documentation.
+      #
+      #   @param fair_market_value_usd [Float, nil] Manual fair-market value in USD (major units) used as the fallback when the rewa
+      #
+      #   @param is_tax_reportable [Boolean, nil] Whether the reward's value counts toward 1099 thresholds/totals. `null` = use th
+    end
+  end
+end

data/lib/growsurf_ruby/models.rb

@@ -75,4 +75,6 @@ module GrowsurfRuby
   ParticipantPayoutList = GrowsurfRuby::Models::ParticipantPayoutList
 
   ReferralList = GrowsurfRuby::Models::ReferralList
+
+  RewardTaxValuation = GrowsurfRuby::Models::RewardTaxValuation
 end

data/lib/growsurf_ruby/resources/campaign/design.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Resources
+    class Campaign
+      class Design
+        # Retrieves a program's design configuration — the same surface as the dashboard
+        # Program Editor's **Design** tab (window layout, header, share channels, signup
+        # form, portal/landing pages, theme styling, and summary/status sections).
+        #
+        # This is a large, deeply nested object whose available fields depend on the
+        # program type. See the API reference for the full field list.
+        #
+        # @overload retrieve(id, request_options: {})
+        #
+        # @param id [String] GrowSurf program ID.
+        #
+        # @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def retrieve(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["campaign/%1$s/design", id],
+            model: GrowsurfRuby::Internal::Type::HashOf[GrowsurfRuby::Internal::Type::Unknown],
+            options: params[:request_options]
+          )
+        end
+
+        # Updates a program's design configuration. Only the fields you send are changed (a
+        # surgical merge; arrays such as `signup.fields` replace wholesale). Unknown
+        # fields, fields not available for the program type, and invalid values return a
+        # `400`.
+        #
+        # The request body is a partial {CampaignDesign} object — see the API reference for
+        # the full field list.
+        #
+        # @overload update(id, body, request_options: {})
+        #
+        # @param id [String] GrowSurf program ID.
+        #
+        # @param body [Hash{Symbol=>Object}] Partial design configuration to merge.
+        #
+        # @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def update(id, body, params = {})
+          @client.request(
+            method: :patch,
+            path: ["campaign/%1$s/design", id],
+            body: body,
+            model: GrowsurfRuby::Internal::Type::HashOf[GrowsurfRuby::Internal::Type::Unknown],
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [GrowsurfRuby::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/growsurf_ruby/resources/campaign/emails.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Resources
+    class Campaign
+      class Emails
+        # Retrieves a program's email configuration — the same surface as the dashboard
+        # Program Editor's **Emails** tab (per-email templates plus sender, contact, and
+        # design settings).
+        #
+        # This is a large, nested object. See the API reference for the full field list.
+        #
+        # @overload retrieve(id, request_options: {})
+        #
+        # @param id [String] GrowSurf program ID.
+        #
+        # @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def retrieve(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["campaign/%1$s/emails", id],
+            model: GrowsurfRuby::Internal::Type::HashOf[GrowsurfRuby::Internal::Type::Unknown],
+            options: params[:request_options]
+          )
+        end
+
+        # Updates a program's email configuration. Only the fields you send are changed.
+        # Unknown fields and invalid values return a `400`.
+        #
+        # The request body is a partial {CampaignEmails} object — see the API reference for
+        # the full field list.
+        #
+        # @overload update(id, body, request_options: {})
+        #
+        # @param id [String] GrowSurf program ID.
+        #
+        # @param body [Hash{Symbol=>Object}] Partial email configuration to merge.
+        #
+        # @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def update(id, body, params = {})
+          @client.request(
+            method: :patch,
+            path: ["campaign/%1$s/emails", id],
+            body: body,
+            model: GrowsurfRuby::Internal::Type::HashOf[GrowsurfRuby::Internal::Type::Unknown],
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [GrowsurfRuby::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/growsurf_ruby/resources/campaign/installation.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Resources
+    class Campaign
+      class Installation
+        # Retrieves a program's installation configuration — the same surface as the
+        # dashboard Program Editor's **Installation** tab (signup and mobile SDK
+        # installation settings).
+        #
+        # This is a nested object whose available fields depend on the program type. See
+        # the API reference for the full field list.
+        #
+        # @overload retrieve(id, request_options: {})
+        #
+        # @param id [String] GrowSurf program ID.
+        #
+        # @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def retrieve(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["campaign/%1$s/installation", id],
+            model: GrowsurfRuby::Internal::Type::HashOf[GrowsurfRuby::Internal::Type::Unknown],
+            options: params[:request_options]
+          )
+        end
+
+        # Updates a program's installation configuration. Only the fields you send are
+        # changed. Unknown fields, fields not available for the program type, and invalid
+        # values return a `400`.
+        #
+        # The request body is a partial {CampaignInstallation} object — see the API
+        # reference for the full field list.
+        #
+        # @overload update(id, body, request_options: {})
+        #
+        # @param id [String] GrowSurf program ID.
+        #
+        # @param body [Hash{Symbol=>Object}] Partial installation configuration to merge.
+        #
+        # @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def update(id, body, params = {})
+          @client.request(
+            method: :patch,
+            path: ["campaign/%1$s/installation", id],
+            body: body,
+            model: GrowsurfRuby::Internal::Type::HashOf[GrowsurfRuby::Internal::Type::Unknown],
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [GrowsurfRuby::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end