growsurf-ruby 1.2.1 → 1.4.0

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

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Models
+    module Campaign
+      # @see GrowsurfRuby::Resources::Campaign::Participant#request_payout_destination_confirmation
+      class ParticipantRequestPayoutDestinationConfirmationResponse < GrowsurfRuby::Internal::Type::BaseModel
+        # @!attribute expires_at
+        #   When the confirmation link expires, as a Unix timestamp in milliseconds.
+        #
+        #   @return [Integer, nil]
+        optional :expires_at, Integer, api_name: :expiresAt, nil?: true
+
+        # @!attribute provider
+        #   The provider the participant was asked to confirm.
+        #
+        #   @return [String, nil]
+        optional :provider, String
+
+        # @!attribute provider_display_name
+        #   The customer-facing provider name (e.g. "PayPal", "Wise").
+        #
+        #   @return [String, nil]
+        optional :provider_display_name, String, api_name: :providerDisplayName
+
+        # @!attribute status
+        #   Confirms the message was requested.
+        #
+        #   @return [Symbol, GrowsurfRuby::Models::Campaign::ParticipantRequestPayoutDestinationConfirmationResponse::Status, nil]
+        optional :status,
+                 enum: -> { GrowsurfRuby::Campaign::ParticipantRequestPayoutDestinationConfirmationResponse::Status }
+
+        # @!method initialize(expires_at: nil, provider: nil, provider_display_name: nil, status: nil)
+        #   @param expires_at [Integer, nil] When the confirmation link expires, as a Unix timestamp in milliseconds.
+        #
+        #   @param provider [String] The provider the participant was asked to confirm.
+        #
+        #   @param provider_display_name [String] The customer-facing provider name (e.g. "PayPal", "Wise").
+        #
+        #   @param status [Symbol, GrowsurfRuby::Models::Campaign::ParticipantRequestPayoutDestinationConfirmationResponse::Status] Confirms the message was requested.
+
+        # Confirms the message was requested.
+        #
+        # @see GrowsurfRuby::Models::Campaign::ParticipantRequestPayoutDestinationConfirmationResponse#status
+        module Status
+          extend GrowsurfRuby::Internal::Type::Enum
+
+          CONFIRMATION_REQUESTED = :CONFIRMATION_REQUESTED
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

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

@@ -19,33 +19,42 @@ module GrowsurfRuby
         required :participant_id_or_email, String
 
         # @!attribute days
-        #   Last number of days to retrieve analytics for. Defaults to 365. Maximum 1825.
+        #   Last number of days for optional `series` and `email` analytics. Defaults to
+        #   365. Maximum 1825. Does not filter the top-level all-time totals.
         #
         #   @return [Integer, nil]
         optional :days, Integer
 
         # @!attribute end_date
-        #   End date of the analytics timeframe as a Unix timestamp in milliseconds.
-        #   Required if `days` is not set.
+        #   End of a custom `series` and `email` analytics window as a Unix timestamp in
+        #   milliseconds. Set it together with `startDate`. Does not filter the top-level
+        #   all-time totals.
         #
         #   @return [Integer, nil]
         optional :end_date, Integer
 
         # @!attribute include
-        #   Set to `series` to also return this participant's own activity per period.
+        #   Comma-separated optional data. `series` returns this participant's own activity
+        #   per period; `email` returns `sent`, `delivered`, `opened`, `clicked`, `bounced`,
+        #   `spamComplaints`, and per-email-type metrics attributed to the participant for
+        #   the requested analytics window (including invitations they sent). Request both
+        #   in either order to add email counts to every series item for emails sent during
+        #   that period. Only documented tokens are accepted; an unknown token returns `400`.
         #
-        #   @return [Symbol, GrowsurfRuby::Models::Campaign::ParticipantRetrieveAnalyticsParams::Include, nil]
-        optional :include, enum: -> { GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Include }
+        #   @return [String, nil]
+        optional :include, String
 
         # @!attribute interval
-        #   Bucket size for the `series` (only used with `include=series`). Defaults to `day`.
+        #   Bucket size for the `series` (only used when `include` contains `series`).
+        #   Defaults to `day`.
         #
         #   @return [Symbol, GrowsurfRuby::Models::Campaign::ParticipantRetrieveAnalyticsParams::Interval, nil]
         optional :interval, enum: -> { GrowsurfRuby::Campaign::ParticipantRetrieveAnalyticsParams::Interval }
 
         # @!attribute start_date
-        #   Start date of the analytics timeframe as a Unix timestamp in milliseconds.
-        #   Required if `days` is not set.
+        #   Start of a custom `series` and `email` analytics window as a Unix timestamp in
+        #   milliseconds. Set it together with `endDate`. Does not filter the top-level
+        #   all-time totals.
         #
         #   @return [Integer, nil]
         optional :start_date, Integer
@@ -59,29 +68,20 @@ module GrowsurfRuby
         #
         #   @param participant_id_or_email [String]
         #
-        #   @param days [Integer] Last number of days to retrieve analytics for. Defaults to 365. Maximum 1825.
+        #   @param days [Integer] Last number of days for optional `series` and `email` analytics. Defaults to 365. Maxi
         #
-        #   @param end_date [Integer] End date of the analytics timeframe as a Unix timestamp in milliseconds. Require
+        #   @param end_date [Integer] End of a custom `series` and `email` analytics window as a Unix timestamp in milli
         #
-        #   @param include [Symbol, GrowsurfRuby::Models::Campaign::ParticipantRetrieveAnalyticsParams::Include] Set to `series` to also return this participant's own activity per period.
+        #   @param include [String] Comma-separated optional data. `series` returns this participant's own activity
         #
-        #   @param interval [Symbol, GrowsurfRuby::Models::Campaign::ParticipantRetrieveAnalyticsParams::Interval] Bucket size for the `series` (only used with `include=series`). Defaults to `day`.
+        #   @param interval [Symbol, GrowsurfRuby::Models::Campaign::ParticipantRetrieveAnalyticsParams::Interval] Bucket size for the `series` (only used when `include` contains `series`).
         #
-        #   @param start_date [Integer] Start date of the analytics timeframe as a Unix timestamp in milliseconds. Requi
+        #   @param start_date [Integer] Start of a custom `series` and `email` analytics window as a Unix timestamp in mi
         #
         #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]
 
-        # Set to `series` to also return this participant's own activity per period.
-        module Include
-          extend GrowsurfRuby::Internal::Type::Enum
-
-          SERIES = :series
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-
-        # Bucket size for the `series` (only used with `include=series`). Defaults to `day`.
+        # Bucket size for the `series` (only used when `include` contains `series`).
+        # Defaults to `day`.
         module Interval
           extend GrowsurfRuby::Internal::Type::Enum
 

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

@@ -93,6 +93,7 @@ module GrowsurfRuby
 
           PENDING = :PENDING
           FULFILLED = :FULFILLED
+          CANCELLED = :CANCELLED
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -18,6 +18,16 @@ module GrowsurfRuby
         #   @return [String]
         required :participant_id_or_email, String
 
+        # @!attribute affiliate_status
+        #   Affiliate programs only. Sets the affiliate status. `APPROVED` also enrolls a
+        #   participant who is not yet an affiliate. `SUSPENDED` and `BANNED` are rejected
+        #   for non-affiliates.
+        #
+        #   @return [Symbol, GrowsurfRuby::Models::Campaign::ParticipantUpdateParams::AffiliateStatus, nil]
+        optional :affiliate_status,
+                 enum: -> { GrowsurfRuby::Campaign::ParticipantUpdateParams::AffiliateStatus },
+                 api_name: :affiliateStatus
+
         # @!attribute email
         #
         #   @return [String, nil]
@@ -46,12 +56,6 @@ module GrowsurfRuby
         #   @return [String, nil]
         optional :notes, String
 
-        # @!attribute paypal_email
-        #   The participant's PayPal email address, used for affiliate payouts.
-        #
-        #   @return [String, nil]
-        optional :paypal_email, String, api_name: :paypalEmail
-
         # @!attribute referral_status
         #
         #   @return [Symbol, GrowsurfRuby::Models::Campaign::ParticipantUpdateParams::ReferralStatus, nil]
@@ -74,7 +78,7 @@ module GrowsurfRuby
         #   @return [Array<String>, nil]
         optional :vanity_keys, GrowsurfRuby::Internal::Type::ArrayOf[String], api_name: :vanityKeys
 
-        # @!method initialize(id:, participant_id_or_email:, email: nil, first_name: nil, last_name: nil, metadata: nil, notes: nil, paypal_email: nil, referral_status: nil, referred_by: nil, unsubscribed: nil, vanity_keys: nil, request_options: {})
+        # @!method initialize(id:, participant_id_or_email:, affiliate_status: nil, email: nil, first_name: nil, last_name: nil, metadata: nil, notes: nil, referral_status: nil, referred_by: nil, unsubscribed: nil, vanity_keys: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {GrowsurfRuby::Models::Campaign::ParticipantUpdateParams} for more details.
         #
@@ -82,6 +86,8 @@ module GrowsurfRuby
         #
         #   @param participant_id_or_email [String]
         #
+        #   @param affiliate_status [Symbol, GrowsurfRuby::Models::Campaign::ParticipantUpdateParams::AffiliateStatus] Affiliate programs only. Sets the affiliate status.
+        #
         #   @param email [String]
         #
         #   @param first_name [String]
@@ -92,8 +98,6 @@ module GrowsurfRuby
         #
         #   @param notes [String] Freeform internal notes about the participant (internal only, never exposed to pa
         #
-        #   @param paypal_email [String] The participant's PayPal email address, used for affiliate payouts.
-        #
         #   @param referral_status [Symbol, GrowsurfRuby::Models::Campaign::ParticipantUpdateParams::ReferralStatus]
         #
         #   @param referred_by [String]
@@ -104,6 +108,18 @@ module GrowsurfRuby
         #
         #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]
 
+        # @see GrowsurfRuby::Models::Campaign::ParticipantUpdateParams#affiliate_status
+        module AffiliateStatus
+          extend GrowsurfRuby::Internal::Type::Enum
+
+          APPROVED = :APPROVED
+          SUSPENDED = :SUSPENDED
+          BANNED = :BANNED
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         module ReferralStatus
           extend GrowsurfRuby::Internal::Type::Enum
 

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

@@ -8,6 +8,9 @@ module GrowsurfRuby
 
         DIRECT = :DIRECT
         PARTICIPANT = :PARTICIPANT
+        DELETED_PARTICIPANT = :DELETED_PARTICIPANT
+        IMPORT = :IMPORT
+        MANUAL = :MANUAL
 
         # @!method self.values
         #   @return [Array<Symbol>]

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

@@ -52,11 +52,26 @@ module GrowsurfRuby
         #   @return [String, nil]
         optional :description, String, nil?: true
 
+        # @!attribute event
+        #   The referral event that earns this Campaign Reward. Present only for
+        #   `SINGLE_SIDED`, `DOUBLE_SIDED`, and `MILESTONE` rewards. Legacy Campaign
+        #   Rewards return `CONVERSION`.
+        #
+        #   @return [Symbol, GrowsurfRuby::Models::Campaign::Reward::Event, nil]
+        optional :event, enum: -> { GrowsurfRuby::Campaign::Reward::Event }, nil?: true
+
         # @!attribute image_url
         #
         #   @return [String, nil]
         optional :image_url, String, api_name: :imageUrl, nil?: true
 
+        # @!attribute is_visible
+        #   Whether the reward is enabled. When `false` the reward is disabled: hidden from
+        #   participants and no longer awarded, including those who already earned it.
+        #
+        #   @return [Boolean, nil]
+        optional :is_visible, GrowsurfRuby::Internal::Type::Boolean, api_name: :isVisible
+
         # @!attribute limit
         #   `-1` represents an unlimited reward in REST responses.
         #
@@ -118,7 +133,7 @@ module GrowsurfRuby
                  api_name: :referredRewardUpfront
 
         # @!attribute referred_value
-        #   Tax valuation for the referred friend's side of a double-sided reward.
+        #   Tax treatment override for the referred friend's side of a double-sided reward.
         #
         #   @return [GrowsurfRuby::Models::RewardTaxValuation, nil]
         optional :referred_value,
@@ -126,13 +141,19 @@ module GrowsurfRuby
                  api_name: :referredValue,
                  nil?: true
 
+        # @!attribute title
+        #   The reward title (internal label).
+        #
+        #   @return [String, nil]
+        optional :title, String, 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)
+        # @!method initialize(id:, is_unlimited:, metadata:, type:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, event: nil, image_url: nil, is_visible: 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, title: nil, value: nil)
         #   @param id [String]
         #
         #   @param is_unlimited [Boolean]
@@ -149,8 +170,12 @@ module GrowsurfRuby
         #
         #   @param description [String, nil]
         #
+        #   @param event [Symbol, GrowsurfRuby::Models::Campaign::Reward::Event, nil] The referral event that earns this Campaign Reward.
+        #
         #   @param image_url [String, nil]
         #
+        #   @param is_visible [Boolean] Whether the reward is enabled. When `false` the reward is disabled: hidden from
+        #
         #   @param limit [Integer, nil] `-1` represents an unlimited reward in REST responses.
         #
         #   @param limit_duration [Symbol, GrowsurfRuby::Models::Campaign::Reward::LimitDuration, nil]
@@ -169,7 +194,9 @@ module GrowsurfRuby
         #
         #   @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 referred_value [GrowsurfRuby::Models::RewardTaxValuation, nil] Tax treatment override for the referred friend's side of a double-sided reward.
+        #
+        #   @param title [String, nil] The reward title (internal label).
         #
         #   @param value [GrowsurfRuby::Models::RewardTaxValuation, nil] Tax valuation for the reward (the referrer's side of a double-sided reward).
 
@@ -187,6 +214,17 @@ module GrowsurfRuby
           #   @return [Array<Symbol>]
         end
 
+        # @see GrowsurfRuby::Models::Campaign::Reward#event
+        module Event
+          extend GrowsurfRuby::Internal::Type::Enum
+
+          LEAD = :LEAD
+          CONVERSION = :CONVERSION
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # @see GrowsurfRuby::Models::Campaign::Reward#limit_duration
         module LimitDuration
           extend GrowsurfRuby::Internal::Type::Enum

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

@@ -38,6 +38,15 @@ module GrowsurfRuby
         #   @return [String, nil]
         optional :description, String
 
+        # @!attribute event
+        #   The referral event that earns this Campaign Reward. Use `LEAD` or
+        #   `CONVERSION`. `LEAD` requires the program installation's `referralTrigger` to
+        #   be `CUSTOM`. This field applies only to `SINGLE_SIDED`, `DOUBLE_SIDED`, and
+        #   `MILESTONE` rewards. When omitted, it defaults to `CONVERSION`.
+        #
+        #   @return [Symbol, GrowsurfRuby::Models::Campaign::RewardCreateParams::Event, nil]
+        optional :event, enum: -> { GrowsurfRuby::Campaign::RewardCreateParams::Event }
+
         # @!attribute image_url
         #
         #   @return [String, nil]
@@ -123,8 +132,8 @@ module GrowsurfRuby
                  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).
+        #   Tax treatment override for the referred friend's side of a double-sided reward.
+        #   Defaults to the program's confirmed default.
         #
         #   @return [GrowsurfRuby::Models::RewardTaxValuation, nil]
         optional :referred_value,
@@ -143,7 +152,7 @@ module GrowsurfRuby
         #   @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_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: {})
+        # @!method initialize(type:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, event: nil, image_url: 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.
         #
@@ -157,6 +166,8 @@ module GrowsurfRuby
         #
         #   @param description [String]
         #
+        #   @param event [Symbol, GrowsurfRuby::Models::Campaign::RewardCreateParams::Event] The referral event that earns this Campaign Reward.
+        #
         #   @param image_url [String]
         #
         #   @param is_unlimited [Boolean] Whether the reward can be earned an unlimited number of times. Defaults to `true
@@ -183,7 +194,7 @@ 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 referred_value [GrowsurfRuby::Models::RewardTaxValuation] Tax treatment override for the referred friend's side of a double-sided reward. Defaults
         #
         #   @param title [String]
         #
@@ -205,6 +216,17 @@ module GrowsurfRuby
           #   @return [Array<Symbol>]
         end
 
+        # @see GrowsurfRuby::Models::Campaign::RewardCreateParams#event
+        module Event
+          extend GrowsurfRuby::Internal::Type::Enum
+
+          LEAD = :LEAD
+          CONVERSION = :CONVERSION
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # @see GrowsurfRuby::Models::Campaign::RewardCreateParams#limit_duration
         module LimitDuration
           extend GrowsurfRuby::Internal::Type::Enum

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

@@ -43,6 +43,15 @@ module GrowsurfRuby
         #   @return [String, nil]
         optional :description, String
 
+        # @!attribute event
+        #   The referral event that earns this Campaign Reward. Use `LEAD` or
+        #   `CONVERSION`. `LEAD` requires the program installation's `referralTrigger` to
+        #   be `CUSTOM`. This field applies only to `SINGLE_SIDED`, `DOUBLE_SIDED`, and
+        #   `MILESTONE` rewards. When omitted, the stored event is preserved.
+        #
+        #   @return [Symbol, GrowsurfRuby::Models::Campaign::RewardUpdateParams::Event, nil]
+        optional :event, enum: -> { GrowsurfRuby::Campaign::RewardUpdateParams::Event }
+
         # @!attribute image_url
         #
         #   @return [String, nil]
@@ -128,8 +137,8 @@ module GrowsurfRuby
                  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).
+        #   Tax treatment override for the referred friend's side of a double-sided reward.
+        #   Defaults to the program's confirmed default.
         #
         #   @return [GrowsurfRuby::Models::RewardTaxValuation, nil]
         optional :referred_value,
@@ -148,7 +157,7 @@ module GrowsurfRuby
         #   @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_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: {})
+        # @!method initialize(id:, campaign_reward_id:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, event: nil, image_url: 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.
         #
@@ -164,6 +173,8 @@ module GrowsurfRuby
         #
         #   @param description [String]
         #
+        #   @param event [Symbol, GrowsurfRuby::Models::Campaign::RewardUpdateParams::Event] The referral event that earns this Campaign Reward.
+        #
         #   @param image_url [String]
         #
         #   @param is_unlimited [Boolean] Whether the reward can be earned an unlimited number of times. Defaults to `true
@@ -190,7 +201,7 @@ 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 referred_value [GrowsurfRuby::Models::RewardTaxValuation] Tax treatment override for the referred friend's side of a double-sided reward. Defaults
         #
         #   @param title [String]
         #
@@ -198,6 +209,17 @@ module GrowsurfRuby
         #
         #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]
 
+        # @see GrowsurfRuby::Models::Campaign::RewardUpdateParams#event
+        module Event
+          extend GrowsurfRuby::Internal::Type::Enum
+
+          LEAD = :LEAD
+          CONVERSION = :CONVERSION
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # @see GrowsurfRuby::Models::Campaign::RewardUpdateParams#limit_duration
         module LimitDuration
           extend GrowsurfRuby::Internal::Type::Enum

data/lib/growsurf_ruby/models/campaign.rb

@@ -120,6 +120,14 @@ module GrowsurfRuby
         #   @return [String, nil]
         optional :description, String, nil?: true
 
+        # @!attribute event
+        #   The referral event that earns this Campaign Reward. Present only for
+        #   `SINGLE_SIDED`, `DOUBLE_SIDED`, and `MILESTONE` rewards. Legacy Campaign
+        #   Rewards return `CONVERSION`.
+        #
+        #   @return [Symbol, GrowsurfRuby::Models::CampaignAPI::Reward::Event, nil]
+        optional :event, enum: -> { GrowsurfRuby::CampaignAPI::Reward::Event }, nil?: true
+
         # @!attribute image_url
         #
         #   @return [String, nil]
@@ -186,7 +194,7 @@ module GrowsurfRuby
                  api_name: :referredRewardUpfront
 
         # @!attribute referred_value
-        #   Tax valuation for the referred friend's side of a double-sided reward.
+        #   Tax treatment override for the referred friend's side of a double-sided reward.
         #
         #   @return [GrowsurfRuby::Models::RewardTaxValuation, nil]
         optional :referred_value,
@@ -200,7 +208,7 @@ module GrowsurfRuby
         #   @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)
+        # @!method initialize(id:, is_unlimited:, metadata:, type:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, event: 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]
@@ -217,6 +225,8 @@ module GrowsurfRuby
         #
         #   @param description [String, nil]
         #
+        #   @param event [Symbol, GrowsurfRuby::Models::CampaignAPI::Reward::Event, nil] The referral event that earns this Campaign Reward.
+        #
         #   @param image_url [String, nil]
         #
         #   @param limit [Integer, nil] `-1` represents an unlimited reward in REST responses.
@@ -237,7 +247,7 @@ module GrowsurfRuby
         #
         #   @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 referred_value [GrowsurfRuby::Models::RewardTaxValuation, nil] Tax treatment override 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).
 
@@ -255,6 +265,17 @@ module GrowsurfRuby
           #   @return [Array<Symbol>]
         end
 
+        # @see GrowsurfRuby::Models::CampaignAPI::Reward#event
+        module Event
+          extend GrowsurfRuby::Internal::Type::Enum
+
+          LEAD = :LEAD
+          CONVERSION = :CONVERSION
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # @see GrowsurfRuby::Models::CampaignAPI::Reward#limit_duration
         module LimitDuration
           extend GrowsurfRuby::Internal::Type::Enum

data/lib/growsurf_ruby/models/campaign_create_affiliate_invite_params.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Models
+    # @see GrowsurfRuby::Resources::Campaign#create_affiliate_invite
+    class CampaignCreateAffiliateInviteParams < GrowsurfRuby::Internal::Type::BaseModel
+      extend GrowsurfRuby::Internal::Type::RequestParameters::Converter
+      include GrowsurfRuby::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute email
+      #   Valid email address to invite. Maximum 255 characters.
+      #
+      #   @return [String]
+      required :email, String
+
+      # @!attribute first_name
+      #   Invitee first name, used in the invite email. Maximum 255 characters.
+      #
+      #   @return [String, nil]
+      optional :first_name, String, api_name: :firstName
+
+      # @!attribute last_name
+      #   Invitee last name. Maximum 255 characters.
+      #
+      #   @return [String, nil]
+      optional :last_name, String, api_name: :lastName
+
+      # @!method initialize(id:, email:, first_name: nil, last_name: nil, request_options: {})
+      #   @param id [String]
+      #
+      #   @param email [String] Valid email address to invite. Maximum 255 characters.
+      #
+      #   @param first_name [String] Invitee first name, used in the invite email. Maximum 255 characters.
+      #
+      #   @param last_name [String] Invitee last name. Maximum 255 characters.
+      #
+      #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/growsurf_ruby/models/campaign_list_affiliate_applications_params.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Models
+    # @see GrowsurfRuby::Resources::Campaign#list_affiliate_applications
+    class CampaignListAffiliateApplicationsParams < GrowsurfRuby::Internal::Type::BaseModel
+      extend GrowsurfRuby::Internal::Type::RequestParameters::Converter
+      include GrowsurfRuby::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute limit
+      #   How many applications to return per page (1-100).
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute offset
+      #   Offset number used to skip through a result set.
+      #
+      #   @return [Integer, nil]
+      optional :offset, Integer
+
+      # @!attribute status
+      #   Only return applications with this status.
+      #
+      #   @return [Symbol, GrowsurfRuby::Models::CampaignListAffiliateApplicationsParams::Status, nil]
+      optional :status, enum: -> { GrowsurfRuby::CampaignListAffiliateApplicationsParams::Status }
+
+      # @!method initialize(id:, limit: nil, offset: nil, status: nil, request_options: {})
+      #   @param id [String]
+      #
+      #   @param limit [Integer] How many applications to return per page (1-100).
+      #
+      #   @param offset [Integer] Offset number used to skip through a result set.
+      #
+      #   @param status [Symbol, GrowsurfRuby::Models::CampaignListAffiliateApplicationsParams::Status] Only return applications with this status.
+      #
+      #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]
+
+      # Only return applications with this status.
+      module Status
+        extend GrowsurfRuby::Internal::Type::Enum
+
+        PENDING = :PENDING
+        APPROVED = :APPROVED
+        DENIED = :DENIED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end