growsurf-ruby 1.2.1 → 1.4.0

data/lib/growsurf_ruby/models/campaign_list_affiliate_invites_params.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Models
+    # @see GrowsurfRuby::Resources::Campaign#list_affiliate_invites
+    class CampaignListAffiliateInvitesParams < 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 invites 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 invites with this status.
+      #
+      #   @return [Symbol, GrowsurfRuby::Models::CampaignListAffiliateInvitesParams::Status, nil]
+      optional :status, enum: -> { GrowsurfRuby::CampaignListAffiliateInvitesParams::Status }
+
+      # @!method initialize(id:, limit: nil, offset: nil, status: nil, request_options: {})
+      #   @param id [String]
+      #
+      #   @param limit [Integer] How many invites to return per page (1-100).
+      #
+      #   @param offset [Integer] Offset number used to skip through a result set.
+      #
+      #   @param status [Symbol, GrowsurfRuby::Models::CampaignListAffiliateInvitesParams::Status] Only return invites with this status.
+      #
+      #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]
+
+      # Only return invites with this status.
+      module Status
+        extend GrowsurfRuby::Internal::Type::Enum
+
+        PENDING = :PENDING
+        ACCEPTED = :ACCEPTED
+        EXPIRED = :EXPIRED
+        REVOKED = :REVOKED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/growsurf_ruby/models/campaign_list_payouts_params.rb

@@ -49,6 +49,7 @@ module GrowsurfRuby
         QUEUED = :QUEUED
         ISSUED = :ISSUED
         FAILED = :FAILED
+        REVERSED = :REVERSED
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/growsurf_ruby/models/campaign_resend_affiliate_invite_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Models
+    # @see GrowsurfRuby::Resources::Campaign#resend_affiliate_invite
+    class CampaignResendAffiliateInviteParams < GrowsurfRuby::Internal::Type::BaseModel
+      extend GrowsurfRuby::Internal::Type::RequestParameters::Converter
+      include GrowsurfRuby::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute invite_id
+      #
+      #   @return [String]
+      required :invite_id, String
+
+      # @!method initialize(id:, invite_id:, request_options: {})
+      #   @param id [String]
+      #   @param invite_id [String]
+      #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/growsurf_ruby/models/campaign_retrieve_affiliate_application_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Models
+    # @see GrowsurfRuby::Resources::Campaign#retrieve_affiliate_application
+    class CampaignRetrieveAffiliateApplicationParams < GrowsurfRuby::Internal::Type::BaseModel
+      extend GrowsurfRuby::Internal::Type::RequestParameters::Converter
+      include GrowsurfRuby::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute application_id
+      #
+      #   @return [String]
+      required :application_id, String
+
+      # @!method initialize(id:, application_id:, request_options: {})
+      #   @param id [String]
+      #   @param application_id [String]
+      #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/growsurf_ruby/models/campaign_retrieve_analytics_params.rb

@@ -26,11 +26,14 @@ module GrowsurfRuby
       optional :end_date, Integer
 
       # @!attribute include
-      #   Comma-separated list of optional enrichments (opt-in to keep the default response
-      #   lean): `previousPeriod` adds totals for the equal-length window immediately before
-      #   the requested one; `statusCounts` adds reward (and, for affiliate programs,
-      #   affiliate/commission/payout) status breakdowns; `rates` adds derived referral
-      #   rates.
+      #   Comma-separated list of optional data to include: `previousPeriod` adds totals for
+      #   the equal-length window immediately before the requested one; `statusCounts` adds
+      #   reward (and, for affiliate programs, affiliate/commission/payout) status breakdowns;
+      #   `rates` adds derived referral rates; `email` adds `sent`, `delivered`, `opened`,
+      #   `clicked`, `bounced`, `spamComplaints`, and per-email-type metrics. When `email` and
+      #   an interval are both requested, each `series` item also contains counts for emails
+      #   sent during that period. Combine `email` with `previousPeriod` to include the same
+      #   email metrics in both windows.
       #
       #   @return [String, nil]
       optional :include, String
@@ -59,7 +62,7 @@ module GrowsurfRuby
       #
       #   @param end_date [Integer] End date of the analytics timeframe as a Unix timestamp in milliseconds. Require
       #
-      #   @param include [String] Comma-separated list of optional enrichments (opt-in to keep the default response
+      #   @param include [String] Comma-separated list of optional data to include: `previousPeriod` adds totals for
       #
       #   @param interval [Symbol, GrowsurfRuby::Models::CampaignRetrieveAnalyticsParams::Interval] When set to `day`, `week`, or `month`, the response also includes a `series` array
       #

data/lib/growsurf_ruby/models/campaign_retrieve_analytics_response.rb

@@ -19,6 +19,9 @@ module GrowsurfRuby
       #   @return [Integer]
       required :start_date, Integer, api_name: :startDate
 
+      # Present only when `include` contains `email`.
+      optional :email, -> { GrowsurfRuby::Models::EmailAnalytics }
+
       # @!attribute previous_period
       #   Present only when `include` contains `previousPeriod`.
       #
@@ -199,6 +202,13 @@ module GrowsurfRuby
         #   @return [Integer, nil]
         optional :twitter_shares, Integer, api_name: :twitterShares
 
+        # @!attribute unique_commission_referrals
+        #   Affiliate programs only. Number of unique referred participants represented by
+        #   commissions in the requested timeframe.
+        #
+        #   @return [Integer, nil]
+        optional :unique_commission_referrals, Integer, api_name: :uniqueCommissionReferrals
+
         # @!attribute unique_impressions
         #
         #   @return [Integer, nil]
@@ -214,7 +224,7 @@ module GrowsurfRuby
         #   @return [Integer, nil]
         optional :whats_app_shares, Integer, api_name: :whatsAppShares
 
-        # @!method initialize(android_native_shares: nil, bluesky_shares: nil, copy_ref_link_shares: nil, email_shares: nil, facebook_shares: nil, impressions: nil, invites: nil, ios_native_shares: nil, linked_in_shares: nil, messenger_shares: nil, participants: nil, pinterest_shares: nil, qrcode_shares: nil, reddit_shares: nil, referral_credit_expireds: nil, referral_credit_pendings: nil, referrals: nil, sms_shares: nil, telegram_shares: nil, threads_shares: nil, total_commission_count: nil, total_commissions: nil, total_revenue: nil, tumblr_shares: nil, twitter_shares: nil, unique_impressions: nil, wechat_shares: nil, whats_app_shares: nil)
+        # @!method initialize(android_native_shares: nil, bluesky_shares: nil, copy_ref_link_shares: nil, email_shares: nil, facebook_shares: nil, impressions: nil, invites: nil, ios_native_shares: nil, linked_in_shares: nil, messenger_shares: nil, participants: nil, pinterest_shares: nil, qrcode_shares: nil, reddit_shares: nil, referral_credit_expireds: nil, referral_credit_pendings: nil, referrals: nil, sms_shares: nil, telegram_shares: nil, threads_shares: nil, total_commission_count: nil, total_commissions: nil, total_revenue: nil, tumblr_shares: nil, twitter_shares: nil, unique_commission_referrals: nil, unique_impressions: nil, wechat_shares: nil, whats_app_shares: nil)
         #   Some parameter documentations has been truncated, see
         #   {GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::Analytics} for more
         #   details.
@@ -269,6 +279,8 @@ module GrowsurfRuby
         #
         #   @param twitter_shares [Integer]
         #
+        #   @param unique_commission_referrals [Integer] Affiliate programs only. Number of unique referred participants represented by commissions in the requested timeframe.
+        #
         #   @param unique_impressions [Integer]
         #
         #   @param wechat_shares [Integer]
@@ -283,6 +295,9 @@ module GrowsurfRuby
         #   @return [GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::Analytics]
         required :analytics, -> { GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::Analytics }
 
+        # Present when the parent request includes both `previousPeriod` and `email`.
+        optional :email, -> { GrowsurfRuby::Models::EmailAnalytics }
+
         # @!attribute end_date
         #
         #   @return [Integer]
@@ -355,6 +370,9 @@ module GrowsurfRuby
         #   @return [Integer, nil]
         optional :email_shares, Integer, api_name: :emailShares
 
+        # Per-period email counts. Present only when `include` contains `email`.
+        optional :email, -> { GrowsurfRuby::Models::EmailAnalytics::Counts }
+
         # @!attribute facebook_shares
         #
         #   @return [Integer, nil]
@@ -470,6 +488,13 @@ module GrowsurfRuby
         #   @return [Integer, nil]
         optional :twitter_shares, Integer, api_name: :twitterShares
 
+        # @!attribute unique_commission_referrals
+        #   Affiliate programs only. Number of unique referred participants represented by
+        #   commissions in the requested timeframe.
+        #
+        #   @return [Integer, nil]
+        optional :unique_commission_referrals, Integer, api_name: :uniqueCommissionReferrals
+
         # @!attribute unique_impressions
         #
         #   @return [Integer, nil]
@@ -485,7 +510,7 @@ module GrowsurfRuby
         #   @return [Integer, nil]
         optional :whats_app_shares, Integer, api_name: :whatsAppShares
 
-        # @!method initialize(android_native_shares: nil, bluesky_shares: nil, copy_ref_link_shares: nil, email_shares: nil, facebook_shares: nil, impressions: nil, invites: nil, ios_native_shares: nil, linked_in_shares: nil, messenger_shares: nil, participants: nil, period_start: nil, pinterest_shares: nil, qrcode_shares: nil, reddit_shares: nil, referral_credit_expireds: nil, referral_credit_pendings: nil, referrals: nil, sms_shares: nil, telegram_shares: nil, threads_shares: nil, total_commission_count: nil, total_commissions: nil, total_revenue: nil, tumblr_shares: nil, twitter_shares: nil, unique_impressions: nil, wechat_shares: nil, whats_app_shares: nil)
+        # @!method initialize(android_native_shares: nil, bluesky_shares: nil, copy_ref_link_shares: nil, email_shares: nil, facebook_shares: nil, impressions: nil, invites: nil, ios_native_shares: nil, linked_in_shares: nil, messenger_shares: nil, participants: nil, period_start: nil, pinterest_shares: nil, qrcode_shares: nil, reddit_shares: nil, referral_credit_expireds: nil, referral_credit_pendings: nil, referrals: nil, sms_shares: nil, telegram_shares: nil, threads_shares: nil, total_commission_count: nil, total_commissions: nil, total_revenue: nil, tumblr_shares: nil, twitter_shares: nil, unique_commission_referrals: nil, unique_impressions: nil, wechat_shares: nil, whats_app_shares: nil)
         #   Some parameter documentations has been truncated, see
         #   {GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::Series} for more
         #   details.
@@ -542,6 +567,8 @@ module GrowsurfRuby
         #
         #   @param twitter_shares [Integer]
         #
+        #   @param unique_commission_referrals [Integer] Affiliate programs only. Number of unique referred participants represented by commissions in the requested timeframe.
+        #
         #   @param unique_impressions [Integer]
         #
         #   @param wechat_shares [Integer]
@@ -711,6 +738,14 @@ module GrowsurfRuby
                      GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::StatusCounts::PayoutStatus::PayoutStatusMetric
                    }
 
+          # @!attribute reversed
+          #
+          #   @return [GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::StatusCounts::PayoutStatus::PayoutStatusMetric, nil]
+          optional :reversed,
+                   -> {
+                     GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::StatusCounts::PayoutStatus::PayoutStatusMetric
+                   }
+
           # @!attribute upcoming
           #
           #   @return [GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::StatusCounts::PayoutStatus::PayoutStatusMetric, nil]
@@ -719,7 +754,7 @@ module GrowsurfRuby
                      GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::StatusCounts::PayoutStatus::PayoutStatusMetric
                    }
 
-          # @!method initialize(failed: nil, issued: nil, queued: nil, upcoming: nil)
+          # @!method initialize(failed: nil, issued: nil, queued: nil, reversed: nil, upcoming: nil)
           #   Affiliate only. Payout counts and amounts by status.
           #
           #   @param failed [GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::StatusCounts::PayoutStatus::PayoutStatusMetric]
@@ -728,6 +763,8 @@ module GrowsurfRuby
           #
           #   @param queued [GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::StatusCounts::PayoutStatus::PayoutStatusMetric]
           #
+          #   @param reversed [GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::StatusCounts::PayoutStatus::PayoutStatusMetric]
+          #
           #   @param upcoming [GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::StatusCounts::PayoutStatus::PayoutStatusMetric]
 
           class PayoutStatusMetric < GrowsurfRuby::Internal::Type::BaseModel
@@ -751,21 +788,32 @@ module GrowsurfRuby
 
         # @see GrowsurfRuby::Models::CampaignRetrieveAnalyticsResponse::StatusCounts#reward_status
         class RewardStatus < GrowsurfRuby::Internal::Type::BaseModel
-          # @!attribute approved
+          # @!attribute completed
+          #   Approved rewards that are fulfilled.
           #
           #   @return [Integer, nil]
-          optional :approved, Integer
+          optional :completed, Integer
 
-          # @!attribute pending
-          #   Unapproved rewards awaiting fulfillment.
+          # @!attribute unapproved
+          #   Unapproved rewards awaiting review.
+          #
+          #   @return [Integer, nil]
+          optional :unapproved, Integer
+
+          # @!attribute unfulfilled
+          #   Rewards that are approved but not fulfilled.
           #
           #   @return [Integer, nil]
-          optional :pending, Integer
+          optional :unfulfilled, Integer
 
-          # @!method initialize(approved: nil, pending: nil)
-          #   @param approved [Integer]
+          # @!method initialize(completed: nil, unapproved: nil, unfulfilled: nil)
+          #   Reward counts grouped by review and fulfillment status.
+          #
+          #   @param completed [Integer] Approved rewards that are fulfilled.
+          #
+          #   @param unapproved [Integer] Unapproved rewards awaiting review.
           #
-          #   @param pending [Integer] Unapproved rewards awaiting fulfillment.
+          #   @param unfulfilled [Integer] Rewards that are approved but not fulfilled.
         end
       end
     end

data/lib/growsurf_ruby/models/campaign_review_affiliate_application_params.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Models
+    # @see GrowsurfRuby::Resources::Campaign#review_affiliate_application
+    # Either decide a pending application with `status`, or move a denied application's
+    # reapplication window with `reapply_allowed_at`. Provide exactly one of those
+    # fields.
+    class CampaignReviewAffiliateApplicationParams < GrowsurfRuby::Internal::Type::BaseModel
+      extend GrowsurfRuby::Internal::Type::RequestParameters::Converter
+      include GrowsurfRuby::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute application_id
+      #
+      #   @return [String]
+      required :application_id, String
+
+      # @!attribute allow_immediate_reapply
+      #   When denying, let the applicant reapply right away instead of waiting out the
+      #   program's reapplication cooldown. Only valid when `status` is `DENIED`.
+      #
+      #   @return [Boolean, nil]
+      optional :allow_immediate_reapply,
+               GrowsurfRuby::Internal::Type::Boolean,
+               api_name: :allowImmediateReapply
+
+      # @!attribute reapply_allowed_at
+      #   For an already-denied application, move the reapplication window to this earlier
+      #   time, in Unix milliseconds. Send without `status`.
+      #
+      #   @return [Integer, nil]
+      optional :reapply_allowed_at, Integer, api_name: :reapplyAllowedAt
+
+      # @!attribute rejection_reason
+      #   Short reason recorded with a denial. Only valid when `status` is `DENIED`.
+      #   Maximum 255 characters.
+      #
+      #   @return [String, nil]
+      optional :rejection_reason, String, api_name: :rejectionReason
+
+      # @!attribute review_note
+      #   Private note recorded with a denial. Only valid when `status` is `DENIED`; never
+      #   shown to the applicant. Maximum 500 characters.
+      #
+      #   @return [String, nil]
+      optional :review_note, String, api_name: :reviewNote
+
+      # @!attribute status
+      #   The decision. `APPROVED` enrolls the applicant as an affiliate; `DENIED` closes
+      #   the application.
+      #
+      #   @return [Symbol, GrowsurfRuby::Models::CampaignReviewAffiliateApplicationParams::Status, nil]
+      optional :status, enum: -> { GrowsurfRuby::CampaignReviewAffiliateApplicationParams::Status }
+
+      # @!method initialize(id:, application_id:, allow_immediate_reapply: nil, reapply_allowed_at: nil, rejection_reason: nil, review_note: nil, status: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {GrowsurfRuby::Models::CampaignReviewAffiliateApplicationParams} for more
+      #   details.
+      #
+      #   @param id [String]
+      #
+      #   @param application_id [String]
+      #
+      #   @param allow_immediate_reapply [Boolean] When denying, let the applicant reapply right away instead of waiting out the
+      #
+      #   @param reapply_allowed_at [Integer] For an already-denied application, move the reapplication window to this earlier
+      #
+      #   @param rejection_reason [String] Short reason recorded with a denial. Only valid when `status` is `DENIED`.
+      #
+      #   @param review_note [String] Private note recorded with a denial. Only valid when `status` is `DENIED`;
+      #
+      #   @param status [Symbol, GrowsurfRuby::Models::CampaignReviewAffiliateApplicationParams::Status] The decision. `APPROVED` enrolls the applicant as an affiliate; `DENIED` closes
+      #
+      #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]
+
+      # The decision. `APPROVED` enrolls the applicant as an affiliate; `DENIED` closes
+      # the application.
+      module Status
+        extend GrowsurfRuby::Internal::Type::Enum
+
+        APPROVED = :APPROVED
+        DENIED = :DENIED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/growsurf_ruby/models/campaign_revoke_affiliate_invite_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Models
+    # @see GrowsurfRuby::Resources::Campaign#revoke_affiliate_invite
+    class CampaignRevokeAffiliateInviteParams < GrowsurfRuby::Internal::Type::BaseModel
+      extend GrowsurfRuby::Internal::Type::RequestParameters::Converter
+      include GrowsurfRuby::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute invite_id
+      #
+      #   @return [String]
+      required :invite_id, String
+
+      # @!method initialize(id:, invite_id:, request_options: {})
+      #   @param id [String]
+      #   @param invite_id [String]
+      #   @param request_options [GrowsurfRuby::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/growsurf_ruby/models/commission_structure.rb

@@ -32,9 +32,10 @@ module GrowsurfRuby
       optional :duration_in_months, Integer, api_name: :durationInMonths, nil?: true
 
       # @!attribute event
+      #   The event that generates a commission. Missing legacy values read as `SALE`.
       #
-      #   @return [String, nil]
-      optional :event, String, nil?: true
+      #   @return [Symbol, GrowsurfRuby::Models::CommissionStructure::Event, nil]
+      optional :event, enum: -> { GrowsurfRuby::CommissionStructure::Event }, nil?: true
 
       # @!attribute has_intro
       #
@@ -112,7 +113,7 @@ module GrowsurfRuby
       #   @param approval_required [Boolean, nil]
       #   @param duration [String, nil]
       #   @param duration_in_months [Integer, nil]
-      #   @param event [String, nil]
+      #   @param event [Symbol, GrowsurfRuby::Models::CommissionStructure::Event, nil]
       #   @param has_intro [Boolean, nil]
       #   @param has_max_amount [Boolean, nil]
       #   @param hold_duration [Integer, nil]
@@ -128,6 +129,18 @@ module GrowsurfRuby
       #   @param percent [Float, nil]
       #   @param type [Symbol, GrowsurfRuby::Models::CommissionStructure::Type, nil]
 
+      # @see GrowsurfRuby::Models::CommissionStructure#event
+      module Event
+        extend GrowsurfRuby::Internal::Type::Enum
+
+        CLICK = :CLICK
+        LEAD = :LEAD
+        SALE = :SALE
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       # @see GrowsurfRuby::Models::CommissionStructure#type
       module Type
         extend GrowsurfRuby::Internal::Type::Enum

data/lib/growsurf_ruby/models/email_analytics.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Models
+    # Accepted-send and lifecycle metrics for program emails in a requested window.
+    class EmailAnalytics < GrowsurfRuby::Internal::Type::BaseModel
+      required :sent, Integer
+      required :delivered, Integer
+      required :opened, Integer
+      required :clicked, Integer
+      required :bounced, Integer
+      required :spam_complaints, Integer, api_name: :spamComplaints
+      required :delivery_rate, Float, api_name: :deliveryRate
+      required :open_rate, Float, api_name: :openRate
+      required :click_rate, Float, api_name: :clickRate
+      required :bounce_rate, Float, api_name: :bounceRate
+      required :by_type,
+               -> { GrowsurfRuby::Internal::Type::ArrayOf[GrowsurfRuby::Models::EmailAnalytics::ByType] },
+               api_name: :byType
+      required :coverage_start_date, Integer, api_name: :coverageStartDate, nil?: true
+      required :is_partial, GrowsurfRuby::Internal::Type::Boolean, api_name: :isPartial
+
+      class Counts < GrowsurfRuby::Internal::Type::BaseModel
+        required :sent, Integer
+        required :delivered, Integer
+        required :opened, Integer
+        required :clicked, Integer
+        required :bounced, Integer
+        required :spam_complaints, Integer, api_name: :spamComplaints
+      end
+
+      class ByType < Counts
+        required :email_type, String, api_name: :emailType
+        required :delivery_rate, Float, api_name: :deliveryRate
+        required :open_rate, Float, api_name: :openRate
+        required :click_rate, Float, api_name: :clickRate
+        required :bounce_rate, Float, api_name: :bounceRate
+      end
+    end
+  end
+end

data/lib/growsurf_ruby/models/participant_commission_list.rb

@@ -46,6 +46,12 @@ module GrowsurfRuby
         #   @return [String]
         required :currency_iso, String, api_name: :currencyISO
 
+        # @!attribute event
+        #   The event that generated this commission. Legacy commissions return `SALE`.
+        #
+        #   @return [Symbol, GrowsurfRuby::Models::ParticipantCommissionList::Commission::Event]
+        required :event, enum: -> { GrowsurfRuby::ParticipantCommissionList::Commission::Event }
+
         # @!attribute referred_id
         #
         #   @return [String]
@@ -129,11 +135,12 @@ module GrowsurfRuby
                  api_name: :saleAmountInCampaignCurrency,
                  nil?: true
 
-        # @!method initialize(id:, amount:, created_at:, currency_iso:, referred_id:, referrer_id:, sale_amount:, status:, amount_in_campaign_currency: nil, approved_at: nil, campaign_currency_iso: nil, exchange_rate: nil, exchange_rate_at: nil, fx_error: nil, hold_duration: nil, paid_at: nil, payout_queued_at: nil, provider: nil, reversed_at: nil, sale_amount_in_campaign_currency: nil)
+        # @!method initialize(id:, amount:, created_at:, currency_iso:, event:, referred_id:, referrer_id:, sale_amount:, status:, amount_in_campaign_currency: nil, approved_at: nil, campaign_currency_iso: nil, exchange_rate: nil, exchange_rate_at: nil, fx_error: nil, hold_duration: nil, paid_at: nil, payout_queued_at: nil, provider: nil, reversed_at: nil, sale_amount_in_campaign_currency: nil)
         #   @param id [String]
         #   @param amount [Integer, nil]
         #   @param created_at [Integer]
         #   @param currency_iso [String]
+        #   @param event [Symbol, GrowsurfRuby::Models::ParticipantCommissionList::Commission::Event] The event that generated this commission. Legacy commissions return `SALE`.
         #   @param referred_id [String]
         #   @param referrer_id [String]
         #   @param sale_amount [Integer, nil]
@@ -151,6 +158,17 @@ module GrowsurfRuby
         #   @param reversed_at [Integer]
         #   @param sale_amount_in_campaign_currency [Integer, nil]
 
+        # @see GrowsurfRuby::Models::ParticipantCommissionList::Commission#event
+        module Event
+          extend GrowsurfRuby::Internal::Type::Enum
+
+          LEAD = :LEAD
+          SALE = :SALE
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # @see GrowsurfRuby::Models::ParticipantCommissionList::Commission#status
         module Status
           extend GrowsurfRuby::Internal::Type::Enum

data/lib/growsurf_ruby/models/participant_payout_list.rb

@@ -106,7 +106,12 @@ module GrowsurfRuby
         #   @return [Integer, nil]
         optional :queued_at, Integer, api_name: :queuedAt
 
-        # @!method initialize(id:, amount:, commission_ids:, created_at:, currency_iso:, participant_id:, status:, amount_in_campaign_currency: nil, campaign_currency_iso: nil, exchange_rate: nil, exchange_rate_at: nil, failed_at: nil, fx_error: nil, issued_at: nil, provider: nil, queued_at: nil)
+        # @!attribute reversed_at
+        #
+        #   @return [Integer, nil]
+        optional :reversed_at, Integer, api_name: :reversedAt
+
+        # @!method initialize(id:, amount:, commission_ids:, created_at:, currency_iso:, participant_id:, status:, amount_in_campaign_currency: nil, campaign_currency_iso: nil, exchange_rate: nil, exchange_rate_at: nil, failed_at: nil, fx_error: nil, issued_at: nil, provider: nil, queued_at: nil, reversed_at: nil)
         #   @param id [String]
         #   @param amount [Integer]
         #   @param commission_ids [Array<String>]
@@ -123,6 +128,7 @@ module GrowsurfRuby
         #   @param issued_at [Integer]
         #   @param provider [String, nil]
         #   @param queued_at [Integer]
+        #   @param reversed_at [Integer]
 
         # @see GrowsurfRuby::Models::ParticipantPayoutList::Payout#status
         module Status
@@ -132,6 +138,7 @@ module GrowsurfRuby
           QUEUED = :QUEUED
           ISSUED = :ISSUED
           FAILED = :FAILED
+          REVERSED = :REVERSED
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/growsurf_ruby/models/reward_tax_valuation.rb

@@ -10,17 +10,18 @@ module GrowsurfRuby
       #   @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.
+      # @!attribute tax_character
+      #   The reason the recipient earns this reward. `null` inherits the program's
+      #   confirmed tax treatment for configurable non-commission rewards. Commission
+      #   rewards always use `NONEMPLOYEE_SERVICES`.
       #
-      #   @return [Boolean, nil]
-      optional :is_tax_reportable,
-               GrowsurfRuby::Internal::Type::Boolean,
-               api_name: :isTaxReportable,
+      #   @return [Symbol, GrowsurfRuby::Models::RewardTaxValuation::TaxCharacter, nil]
+      optional :tax_character,
+               enum: -> { GrowsurfRuby::RewardTaxValuation::TaxCharacter },
+               api_name: :taxCharacter,
                nil?: true
 
-      # @!method initialize(fair_market_value_usd: nil, is_tax_reportable: nil)
+      # @!method initialize(fair_market_value_usd: nil, tax_character: nil)
       #   Some parameter documentations has been truncated, see
       #   {GrowsurfRuby::Models::RewardTaxValuation} for more details.
       #
@@ -29,7 +30,21 @@ module GrowsurfRuby
       #
       #   @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
+      #   @param tax_character [Symbol, GrowsurfRuby::Models::RewardTaxValuation::TaxCharacter, nil] The reason the recipient earns this reward. `null` inherits the program's
+
+      # The U.S. federal tax character of a reward.
+      module TaxCharacter
+        extend GrowsurfRuby::Internal::Type::Enum
+
+        NONEMPLOYEE_SERVICES = :NONEMPLOYEE_SERVICES
+        PRIZE_OR_AWARD = :PRIZE_OR_AWARD
+        PURCHASE_REBATE = :PURCHASE_REBATE
+        OTHER_INCOME = :OTHER_INCOME
+        REVIEW_REQUIRED = :REVIEW_REQUIRED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end