growsurf-ruby 1.11.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0a3b95b3133ce558497796181239db19722afbbf33c3fde584ff1dfce27baac
-  data.tar.gz: 5ffe4cc507ca7b364e2f58c73dc27b0f7bbafd10b1e6b05e071cc6798b5a0660
+  metadata.gz: 442841d57191df0f9e6a803984d7d76ef7dc3e61b2cd7820ac89c0a07c69cb53
+  data.tar.gz: 33068c528f6fc764da5801b39c604259fdb4538dedbbe29b5131d8c634048602
 SHA512:
-  metadata.gz: ca08b82af5a3c2440221d8f1a281fad243d87d1c92a368968bc9ec225e4b3d13964a87379e1b2fc94a396e97147ff56d2ba811a99975bb14f189fe61ca0603fc
-  data.tar.gz: 1cbba60543073bbec8a4630859f97e36fe99c148886283c177daa839c48dc6a0b6ab5a864c2b3b76a732c402a145e84d6604c771beeeb98a7ce9d6995673b0ec
+  metadata.gz: 3b03ce3772e8ae528438e52a4945e68fa119e74839e364625952038aa0d87238dcecdb8afcae01e62fd560f33adeb6d2d462d3742be21ce4ce8646244f2c9799
+  data.tar.gz: 1e4fbeaef362092363b5d9eccdb3ce9e4b7331f44cfebc7874099b367662c0d7dc2b771ebb0d1e3dcac63f1af167d4ca5792b14886d269a9349cc6c18ac97af0

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [1.13.0](https://github.com/growsurf/growsurf-ruby/compare/v1.12.0...v1.13.0) (2026-10-09)
+
+
+### Features
+
+* add program and participant language support ([22ddc3e](https://github.com/growsurf/growsurf-ruby/commit/22ddc3e0b9ea5c63be36d5ebc1ffb49730712197))
+* add program languages and update SDK maintenance guidance ([d7a8ec1](https://github.com/growsurf/growsurf-ruby/commit/d7a8ec1f4f0ef0ed4918312ba9ac6d698da2667c))
+
+## [1.12.0](https://github.com/growsurf/growsurf-ruby/compare/v1.11.0...v1.12.0) (2026-10-07)
+
+
+### Chores
+
+* prepare SDK 1.12.0 ([d163c5e](https://github.com/growsurf/growsurf-ruby/commit/d163c5e7fda6400d44ae79a985763d50ead59b40))
+* release 1.12.0 ([e2d8538](https://github.com/growsurf/growsurf-ruby/commit/e2d853807892abd014ec31c9865cb2b01d0663a7))
+
+
+### Documentation
+
+* clarify welcome email recipient eligibility ([7b91dc6](https://github.com/growsurf/growsurf-ruby/commit/7b91dc651b2456f2e944735b72870045ff8c6ae2))
+* describe follow-up reminder eligibility and delay ([cc938ab](https://github.com/growsurf/growsurf-ruby/commit/cc938ab446327df49d9814b13f66002493d5b3c7))
+* describe inline email layout and required footer token ([8d0d06c](https://github.com/growsurf/growsurf-ruby/commit/8d0d06c94793453447278c7e5294cffece80deb9))
+
 ## [1.11.0](https://github.com/growsurf/growsurf-ruby/compare/v1.10.0...v1.11.0) (2026-09-29)
 
 

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", "~> 1.11.0"
+gem "growsurf-ruby", "~> 1.13.0"
 ```
 
 <!-- x-release-please-end -->
@@ -130,7 +130,7 @@ All parameter and response objects inherit from `GrowsurfRuby::Internal::Type::B
 
 You can send undocumented parameters to any endpoint, and read undocumented response properties, like so:
 
-Note: the `extra_` parameters of the same name overrides the documented parameters.
+Note: the `extra_` parameters of the same name override the documented parameters.
 
 ```ruby
 campaigns =
@@ -165,7 +165,7 @@ response = client.request(
 
 ### Concurrency & connection pooling
 
-The `GrowsurfRuby::Client` instances are threadsafe, but are only are fork-safe when there are no in-flight HTTP requests.
+The `GrowsurfRuby::Client` instances are threadsafe, but are only fork-safe when there are no in-flight HTTP requests.
 
 Each instance of `GrowsurfRuby::Client` has its own HTTP connection pool with a default size of 99. As such, we recommend instantiating the client once per application in most settings.
 
@@ -196,7 +196,7 @@ growsurf.campaign.list(**params)
 
 ### Enums
 
-Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols" instead, which is always a primitive at runtime:
+Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols", which are always primitives at runtime:
 
 ```ruby
 # :CREDIT_PENDING

data/SECURITY.md

@@ -2,22 +2,12 @@
 
 ## Reporting Security Issues
 
-This SDK is generated by [Stainless Software Inc](http://stainless.com). Stainless takes security seriously, and encourages you to report any security vulnerability promptly so that appropriate action can be taken.
-
-To report a security issue, please contact the Stainless team at security@stainless.com.
+GrowSurf maintains this SDK. If you believe you have found a security vulnerability in it, please report it to support@growsurf.com rather than opening a public issue.
 
 ## Responsible Disclosure
 
-We appreciate the efforts of security researchers and individuals who help us maintain the security of
-SDKs we generate. If you believe you have found a security vulnerability, please adhere to responsible
-disclosure practices by allowing us a reasonable amount of time to investigate and address the issue
-before making any information public.
-
-## Reporting Non-SDK Related Security Issues
-
-If you encounter security issues that are not directly related to SDKs but pertain to the services
-or products provided by Growsurf, please follow the respective company's security reporting guidelines.
+Please give us a reasonable amount of time to investigate and address the issue before making any information public. We appreciate the efforts of security researchers who help keep this SDK and the systems it talks to secure.
 
----
+## Other GrowSurf Security Issues
 
-Thank you for helping us keep the SDKs and systems they interact with secure.
+For security issues in GrowSurf products or services that are not related to this SDK, contact support@growsurf.com as well.

data/lib/growsurf_ruby/internal/transport/base_client.rb

@@ -117,7 +117,7 @@ module GrowsurfRuby
 
             case [url.scheme, location.scheme]
             in ["https", "http"]
-              message = "Tried to redirect to a insecure URL"
+              message = "Tried to redirect to an insecure URL"
               raise GrowsurfRuby::Errors::APIConnectionError.new(
                 url: url,
                 response: response_headers,

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

@@ -33,6 +33,13 @@ module GrowsurfRuby
         #   @return [Boolean, nil]
         optional :is_affiliate, GrowsurfRuby::Internal::Type::Boolean, api_name: :isAffiliate
 
+        # @!attribute language
+        #   The language of the participant's portal and program emails. Must be one of the
+        #   program's languages. Applied only when this request creates the participant.
+        #
+        #   @return [Symbol, GrowsurfRuby::Models::Campaign::Language, nil]
+        optional :language, enum: -> { GrowsurfRuby::Campaign::Language }
+
         # @!attribute last_name
         #
         #   @return [String, nil]
@@ -69,7 +76,7 @@ module GrowsurfRuby
         #   @return [String, nil]
         optional :referred_by, String, api_name: :referredBy
 
-        # @!method initialize(email:, fingerprint: nil, first_name: nil, ip_address: nil, is_affiliate: nil, last_name: nil, metadata: nil, mobile_instance_id: nil, referral_status: nil, referred_by: nil)
+        # @!method initialize(email:, fingerprint: nil, first_name: nil, ip_address: nil, is_affiliate: nil, language: nil, last_name: nil, metadata: nil, mobile_instance_id: nil, referral_status: nil, referred_by: nil)
         #   Some parameter documentations has been truncated, see
         #   {GrowsurfRuby::Models::Campaign::Create} for more details.
         #
@@ -83,6 +90,8 @@ module GrowsurfRuby
         #
         #   @param is_affiliate [Boolean] Affiliate programs only. Controls affiliate enrollment for a new participant.
         #
+        #   @param language [Symbol, GrowsurfRuby::Models::Campaign::Language] The language of the participant's portal and program emails. Must be one of the
+        #
         #   @param last_name [String]
         #
         #   @param metadata [Hash{Symbol=>Object}] Shallow custom metadata object.

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module GrowsurfRuby
+  module Models
+    module Campaign
+      # A language a program can run in. Participants see the portal and receive
+      # program emails in their language.
+      module Language
+        extend GrowsurfRuby::Internal::Type::Enum
+
+        EN = :en
+        ES = :es
+        FR = :fr
+        DE = :de
+        IT = :it
+        PT_BR = :"pt-BR"
+        NL = :nl
+        PL = :pl
+        SV = :sv
+        TR = :tr
+        JA = :ja
+        KO = :ko
+        ZH_CN = :"zh-CN"
+        ID = :id
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

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

@@ -130,6 +130,14 @@ module GrowsurfRuby
         #   @return [Boolean, nil]
         optional :is_winner, GrowsurfRuby::Internal::Type::Boolean, api_name: :isWinner
 
+        # @!attribute language
+        #   The language of the participant's portal and program emails. The program's base
+        #   language unless the participant (or you) picked another of the program's
+        #   languages.
+        #
+        #   @return [Symbol, GrowsurfRuby::Models::Campaign::Language, nil]
+        optional :language, enum: -> { GrowsurfRuby::Campaign::Language }
+
         # @!attribute last_name
         #
         #   @return [String, nil]
@@ -256,7 +264,7 @@ module GrowsurfRuby
         #   @return [Array<String>, nil]
         optional :vanity_keys, GrowsurfRuby::Internal::Type::ArrayOf[String], api_name: :vanityKeys
 
-        # @!method initialize(id:, email:, monthly_rank:, monthly_referral_count:, rank:, referral_count:, rewards:, share_url: nil, affiliate_enrollment_source: nil, affiliate_status: nil, all_matching_fraudsters: nil, created_at: nil, fingerprint: nil, first_name: nil, fraud_reason_code: nil, fraud_risk_level: nil, impression_count: nil, invite_count: nil, ip_address: nil, is_affiliate: nil, is_new: nil, is_winner: nil, last_name: nil, lead_count: nil, metadata: nil, mobile_instance_id: nil, monthly_referrals: nil, notes: nil, payout_settings: nil, paypal_email_address: nil, prev_monthly_rank: nil, prev_monthly_referral_count: nil, referrals: nil, referral_source: nil, referral_status: nil, referred_by: nil, referrer: nil, share_count: nil, unique_impression_count: nil, unread_commissions_count: nil, unread_payouts_count: nil, unsubscribed: nil, vanity_keys: nil)
+        # @!method initialize(id:, email:, monthly_rank:, monthly_referral_count:, rank:, referral_count:, rewards:, share_url: nil, affiliate_enrollment_source: nil, affiliate_status: nil, all_matching_fraudsters: nil, created_at: nil, fingerprint: nil, first_name: nil, fraud_reason_code: nil, fraud_risk_level: nil, impression_count: nil, invite_count: nil, ip_address: nil, is_affiliate: nil, is_new: nil, is_winner: nil, language: nil, last_name: nil, lead_count: nil, metadata: nil, mobile_instance_id: nil, monthly_referrals: nil, notes: nil, payout_settings: nil, paypal_email_address: nil, prev_monthly_rank: nil, prev_monthly_referral_count: nil, referrals: nil, referral_source: nil, referral_status: nil, referred_by: nil, referrer: nil, share_count: nil, unique_impression_count: nil, unread_commissions_count: nil, unread_payouts_count: nil, unsubscribed: nil, vanity_keys: nil)
         #   Some parameter documentations has been truncated, see
         #   {GrowsurfRuby::Models::Campaign::CampaignParticipant} for more details.
         #
@@ -305,6 +313,8 @@ module GrowsurfRuby
         #
         #   @param is_winner [Boolean]
         #
+        #   @param language [Symbol, GrowsurfRuby::Models::Campaign::Language] The language of the participant's portal and program emails. The program's base
+        #
         #   @param last_name [String, nil]
         #
         #   @param lead_count [Integer] The number of pending referrals the participant made that have not converted

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

@@ -36,6 +36,8 @@ module GrowsurfRuby
         #   `referredSignup`, `commissionGenerated`, `commissionAdjusted`, `payoutPending`,
         #   `payoutSentSuccess`, `progressUpdateMonthly`. System/transactional types (login
         #   link, PayPal confirmation, tax) and the invite email cannot be sent.
+        #   `welcomeNonReferred` can only be sent to advocates or approved, enrolled affiliates in a
+        #   program that has not ended.
         #
         #   @return [String, nil]
         optional :email_type, String, api_name: :emailType

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

@@ -38,6 +38,14 @@ module GrowsurfRuby
         #   @return [String, nil]
         optional :first_name, String, api_name: :firstName
 
+        # @!attribute language
+        #   The language of the participant's portal and program emails. Must be one of the
+        #   program's languages (see `languages` in the program options). Send the base
+        #   language or `null` to use the program's base language.
+        #
+        #   @return [Symbol, GrowsurfRuby::Models::Campaign::Language, nil]
+        optional :language, enum: -> { GrowsurfRuby::Campaign::Language }, nil?: true
+
         # @!attribute last_name
         #
         #   @return [String, nil]
@@ -78,7 +86,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:, 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: {})
+        # @!method initialize(id:, participant_id_or_email:, affiliate_status: nil, email: nil, first_name: nil, language: 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.
         #
@@ -92,6 +100,8 @@ module GrowsurfRuby
         #
         #   @param first_name [String]
         #
+        #   @param language [Symbol, GrowsurfRuby::Models::Campaign::Language, nil] The language of the participant's portal and program emails. Must be one of the
+        #
         #   @param last_name [String]
         #
         #   @param metadata [Hash{Symbol=>Object}] Shallow custom metadata object.

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

@@ -7,9 +7,15 @@ module GrowsurfRuby
         # Retrieves a program's email configuration — the same surface as the dashboard
         # Program Editor's **Emails** tab. Returns each editable email template
         # (`subject`, `preheader`, `body`, `isEnabled`) plus the `settings` block (sender,
-        # contact, and design). The set of email templates returned depends on the program
+        # contact, and design). New programs return read-only `settings.design.layoutMode`
+        # as `INLINE`: bodies require `{{emailFooter}}`; `{{emailHeader}}` is optional.
+        # Older programs omit the mode and keep their existing layout. The set of email templates returned depends on the program
         # type (referral vs affiliate). `offerClaimed` is available to both program types and sends
         # while the Claim Offer Popup is enabled.
+        # `followUpReminder` is disabled by default. It reminds the referrer about new
+        # invitations sent while enabled when the contacts have not signed up.
+        # `delayDays` accepts integers from 2 to 30 (default 3); changing it leaves
+        # existing reminder dates unchanged.
         #
         # @overload retrieve(id, request_options: {})
         #

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

@@ -7,8 +7,9 @@ module GrowsurfRuby
         # Retrieves a program's options — the same surface as the dashboard Program
         # Editor's **Options** tab. Includes reward/fraud approval, anti-fraud lists +
         # toggles, referral cookie/credit windows, reCAPTCHA, affiliate enrollment +
-        # application review, payout threshold + tax settings (affiliate only), and
-        # notification-email settings. `fraud.recaptcha.secretKey` is never returned.
+        # application review, payout threshold + tax settings (affiliate only),
+        # notification-email settings, and the program's languages.
+        # `fraud.recaptcha.secretKey` is never returned.
         #
         # @overload retrieve(id, request_options: {})
         #
@@ -32,6 +33,8 @@ module GrowsurfRuby
         # and `payoutThreshold`/`taxDocumentation` are affiliate-only, and affiliate
         # programs require `requireParticipantAuth: true`). `fraud.recaptcha.secretKey`
         # is write-only. `referralCreditWindowDays: null` means "never expires".
+        # Turning on `languages.additionalLanguages` requires the Business plan or
+        # higher (`403` otherwise).
         #
         # @overload update(id, body, request_options: {})
         #

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

@@ -37,7 +37,7 @@ module GrowsurfRuby
         # require an existing affiliate. This endpoint does not accept `isAffiliate`, and
         # affiliate enrollment cannot be removed through REST.
         #
-        # @overload update(participant_id_or_email, id:, 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: {})
+        # @overload update(participant_id_or_email, id:, affiliate_status: nil, email: nil, first_name: nil, language: nil, last_name: nil, metadata: nil, notes: nil, referral_status: nil, referred_by: nil, unsubscribed: nil, vanity_keys: nil, request_options: {})
         #
         # @param participant_id_or_email [String] Path param: GrowSurf participant ID or unencoded participant email address (the SDK encodes it automatically).
         #
@@ -49,6 +49,8 @@ module GrowsurfRuby
         #
         # @param first_name [String] Body param
         #
+        # @param language [Symbol, GrowsurfRuby::Models::Campaign::Language, nil] Body param: The language of the participant's portal and program emails. Must be one of the program's languages (see `languages` in the program options). Send the base language or `null` to use the program's base language.
+        #
         # @param last_name [String] Body param
         #
         # @param metadata [Hash{Symbol=>Object}] Body param: Shallow custom metadata object.
@@ -155,7 +157,7 @@ module GrowsurfRuby
         # `isAffiliate: true` to keep the referral attribution and enroll the participant
         # as an affiliate.
         #
-        # @overload add(id, email:, fingerprint: nil, first_name: nil, ip_address: nil, is_affiliate: nil, last_name: nil, metadata: nil, mobile_instance_id: nil, referral_status: nil, referred_by: nil, request_options: {})
+        # @overload add(id, email:, fingerprint: nil, first_name: nil, ip_address: nil, is_affiliate: nil, language: nil, last_name: nil, metadata: nil, mobile_instance_id: nil, referral_status: nil, referred_by: nil, request_options: {})
         #
         # @param id [String] GrowSurf program ID.
         #
@@ -169,6 +171,8 @@ module GrowsurfRuby
         #
         # @param is_affiliate [Boolean] Affiliate programs only. Controls affiliate enrollment for a new participant. `true` enrolls the participant with `affiliateStatus: APPROVED`; `false` creates a non-affiliate without `affiliateStatus`. Existing participants are returned unchanged.
         #
+        # @param language [Symbol, GrowsurfRuby::Models::Campaign::Language] The language of the participant's portal and program emails. Must be one of the program's languages. Applied only when this request creates the participant.
+        #
         # @param last_name [String]
         #
         # @param metadata [Hash{Symbol=>Object}] Shallow custom metadata object.
@@ -607,7 +611,7 @@ module GrowsurfRuby
         # name, postal address, and an unsubscribe link are added automatically, and
         # unsubscribed participants are suppressed). Sending requires the team to be
         # verified by GrowSurf. Requires a **verified custom email domain** on the program
-        # (which can be completed in *Campaign Editor > 3. Emails > Email Settings*).
+        # (which can be completed in *Program Editor > 3. Emails > Email Settings*).
         # Returns `400` until one is verified. The email is accepted for delivery.
         #
         # @overload email(participant_id_or_email, id:, body: nil, email_type: nil, preheader: nil, subject: nil, request_options: {})

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

@@ -5,8 +5,8 @@ module GrowsurfRuby
     class Campaign
       # Participant reward retrieval and manual reward operations.
       class Reward
-        # Removes a manually approved participant reward that has not already been
-        # approved.
+        # Removes a participant reward that requires manual approval and has not yet
+        # been approved.
         #
         # @overload delete(reward_id, id:, request_options: {})
         #
@@ -33,7 +33,7 @@ module GrowsurfRuby
           )
         end
 
-        # Approves a manually approved reward earned by a participant. This requires
+        # Approves a participant reward that requires manual approval. This requires
         # `reward:write`. When the request also sets `fulfill` to `true`, it additionally
         # requires `reward:fulfill`.
         #

data/lib/growsurf_ruby/resources/campaign.rb

@@ -235,7 +235,7 @@ module GrowsurfRuby
       # participant endpoints. Use this endpoint from your backend after your mobile app
       # authenticates a signed-in user. The program must have mobile SDK access enabled.
       #
-      # @overload create_mobile_participant_token(id, email:, fingerprint: nil, first_name: nil, ip_address: nil, last_name: nil, metadata: nil, mobile_instance_id: nil, referral_status: nil, referred_by: nil, request_options: {})
+      # @overload create_mobile_participant_token(id, email:, fingerprint: nil, first_name: nil, ip_address: nil, language: nil, last_name: nil, metadata: nil, mobile_instance_id: nil, referral_status: nil, referred_by: nil, request_options: {})
       #
       # @param id [String] GrowSurf program ID.
       #
@@ -247,6 +247,8 @@ module GrowsurfRuby
       #
       # @param ip_address [String]
       #
+      # @param language [Symbol, GrowsurfRuby::Models::Campaign::Language] The language of the participant's portal and program emails. Must be one of the program's languages. Applied only when this request creates the participant.
+      #
       # @param last_name [String]
       #
       # @param metadata [Hash{Symbol=>Object}] Shallow custom metadata object.

data/lib/growsurf_ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GrowsurfRuby
-  VERSION = "1.11.0"
+  VERSION = "1.13.0"
 end

data/lib/growsurf_ruby.rb

@@ -65,6 +65,7 @@ require_relative "growsurf_ruby/models/campaign/commission_delete_params"
 require_relative "growsurf_ruby/models/campaign/commission_delete_response"
 require_relative "growsurf_ruby/models/campaign/delete_reward_response"
 require_relative "growsurf_ruby/models/campaign/fraud_risk_level"
+require_relative "growsurf_ruby/models/campaign/language"
 require_relative "growsurf_ruby/models/campaign/participant_activity_logs_response"
 require_relative "growsurf_ruby/models/campaign/participant_add_params"
 require_relative "growsurf_ruby/models/campaign/participant_activation_analytics"

data/rbi/growsurf_ruby/models/campaign/create.rbi

@@ -43,6 +43,16 @@ module GrowsurfRuby
         sig { params(is_affiliate: T::Boolean).void }
         attr_writer :is_affiliate
 
+        # The language of the participant's portal and program emails. Must be one of the
+        # program's languages. Applied only when this request creates the participant.
+        sig { returns(T.nilable(GrowsurfRuby::Campaign::Language::OrSymbol)) }
+        attr_reader :language
+
+        sig do
+          params(language: GrowsurfRuby::Campaign::Language::OrSymbol).void
+        end
+        attr_writer :language
+
         sig { returns(T.nilable(String)) }
         attr_reader :last_name
 
@@ -98,6 +108,7 @@ module GrowsurfRuby
             first_name: String,
             ip_address: String,
             is_affiliate: T::Boolean,
+            language: GrowsurfRuby::Campaign::Language::OrSymbol,
             last_name: String,
             metadata: T::Hash[Symbol, T.anything],
             mobile_instance_id: String,
@@ -116,6 +127,9 @@ module GrowsurfRuby
           # a non-affiliate without `affiliateStatus`. Existing participants are returned
           # unchanged.
           is_affiliate: nil,
+          # The language of the participant's portal and program emails. Must be one of the
+          # program's languages. Applied only when this request creates the participant.
+          language: nil,
           last_name: nil,
           # Shallow custom metadata object.
           metadata: nil,
@@ -141,6 +155,7 @@ module GrowsurfRuby
               first_name: String,
               ip_address: String,
               is_affiliate: T::Boolean,
+              language: GrowsurfRuby::Campaign::Language::OrSymbol,
               last_name: String,
               metadata: T::Hash[Symbol, T.anything],
               mobile_instance_id: String,

data/rbi/growsurf_ruby/models/campaign/language.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module GrowsurfRuby
+  module Models
+    module Campaign
+      # A language a program can run in. Participants see the portal and receive
+      # program emails in their language.
+      module Language
+        extend GrowsurfRuby::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, GrowsurfRuby::Campaign::Language) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        EN = T.let(:en, GrowsurfRuby::Campaign::Language::TaggedSymbol)
+        ES = T.let(:es, GrowsurfRuby::Campaign::Language::TaggedSymbol)
+        FR = T.let(:fr, GrowsurfRuby::Campaign::Language::TaggedSymbol)
+        DE = T.let(:de, GrowsurfRuby::Campaign::Language::TaggedSymbol)
+        IT = T.let(:it, GrowsurfRuby::Campaign::Language::TaggedSymbol)
+        PT_BR = T.let(:"pt-BR", GrowsurfRuby::Campaign::Language::TaggedSymbol)
+        NL = T.let(:nl, GrowsurfRuby::Campaign::Language::TaggedSymbol)
+        PL = T.let(:pl, GrowsurfRuby::Campaign::Language::TaggedSymbol)
+        SV = T.let(:sv, GrowsurfRuby::Campaign::Language::TaggedSymbol)
+        TR = T.let(:tr, GrowsurfRuby::Campaign::Language::TaggedSymbol)
+        JA = T.let(:ja, GrowsurfRuby::Campaign::Language::TaggedSymbol)
+        KO = T.let(:ko, GrowsurfRuby::Campaign::Language::TaggedSymbol)
+        ZH_CN = T.let(:"zh-CN", GrowsurfRuby::Campaign::Language::TaggedSymbol)
+        ID = T.let(:id, GrowsurfRuby::Campaign::Language::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[GrowsurfRuby::Campaign::Language::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/growsurf_ruby/models/campaign/participant.rbi

@@ -129,6 +129,19 @@ module GrowsurfRuby
         sig { params(is_winner: T::Boolean).void }
         attr_writer :is_winner
 
+        # The language of the participant's portal and program emails. The program's base
+        # language unless the participant (or you) picked another of the program's
+        # languages.
+        sig do
+          returns(T.nilable(GrowsurfRuby::Campaign::Language::TaggedSymbol))
+        end
+        attr_reader :language
+
+        sig do
+          params(language: GrowsurfRuby::Campaign::Language::OrSymbol).void
+        end
+        attr_writer :language
+
         sig { returns(T.nilable(String)) }
         attr_accessor :last_name
 
@@ -318,6 +331,7 @@ module GrowsurfRuby
             is_affiliate: T::Boolean,
             is_new: T::Boolean,
             is_winner: T::Boolean,
+            language: GrowsurfRuby::Campaign::Language::OrSymbol,
             last_name: T.nilable(String),
             lead_count: Integer,
             metadata: T::Hash[Symbol, T.anything],
@@ -377,6 +391,10 @@ module GrowsurfRuby
           is_affiliate: nil,
           is_new: nil,
           is_winner: nil,
+          # The language of the participant's portal and program emails. The program's base
+          # language unless the participant (or you) picked another of the program's
+          # languages.
+          language: nil,
           last_name: nil,
           # The number of pending referrals the participant made that have not converted
           # into successful referrals yet.
@@ -436,6 +454,7 @@ module GrowsurfRuby
               is_affiliate: T::Boolean,
               is_new: T::Boolean,
               is_winner: T::Boolean,
+              language: GrowsurfRuby::Campaign::Language::TaggedSymbol,
               last_name: T.nilable(String),
               lead_count: Integer,
               metadata: T::Hash[Symbol, T.anything],

data/rbi/growsurf_ruby/models/campaign/participant_update_params.rbi

@@ -53,6 +53,12 @@ module GrowsurfRuby
         sig { params(first_name: String).void }
         attr_writer :first_name
 
+        # The language of the participant's portal and program emails. Must be one of the
+        # program's languages (see `languages` in the program options). Send the base
+        # language or `null` to use the program's base language.
+        sig { returns(T.nilable(GrowsurfRuby::Campaign::Language::OrSymbol)) }
+        attr_accessor :language
+
         sig { returns(T.nilable(String)) }
         attr_reader :last_name
 
@@ -117,6 +123,7 @@ module GrowsurfRuby
               GrowsurfRuby::Campaign::ParticipantUpdateParams::AffiliateStatus::OrSymbol,
             email: String,
             first_name: String,
+            language: T.nilable(GrowsurfRuby::Campaign::Language::OrSymbol),
             last_name: String,
             metadata: T::Hash[Symbol, T.anything],
             notes: String,
@@ -137,6 +144,10 @@ module GrowsurfRuby
           affiliate_status: nil,
           email: nil,
           first_name: nil,
+          # The language of the participant's portal and program emails. Must be one of the
+          # program's languages (see `languages` in the program options). Send the base
+          # language or `null` to use the program's base language.
+          language: nil,
           last_name: nil,
           # Shallow custom metadata object.
           metadata: nil,
@@ -160,6 +171,7 @@ module GrowsurfRuby
                 GrowsurfRuby::Campaign::ParticipantUpdateParams::AffiliateStatus::OrSymbol,
               email: String,
               first_name: String,
+              language: T.nilable(GrowsurfRuby::Campaign::Language::OrSymbol),
               last_name: String,
               metadata: T::Hash[Symbol, T.anything],
               notes: String,

data/rbi/growsurf_ruby/resources/campaign/emails.rbi

@@ -10,6 +10,10 @@ module GrowsurfRuby
         # contact, and design). The set of email templates returned depends on the program
         # type (referral vs affiliate). `offerClaimed` is available to both program types and sends
         # while the Claim Offer Popup is enabled.
+        # `followUpReminder` is disabled by default. It reminds the referrer about new
+        # invitations sent while enabled when the contacts have not signed up.
+        # `delayDays` accepts integers from 2 to 30 (default 3); changing it leaves
+        # existing reminder dates unchanged.
         sig do
           params(
             id: String,

data/rbi/growsurf_ruby/resources/campaign/options.rbi

@@ -7,8 +7,9 @@ module GrowsurfRuby
         # Retrieves a program's options — the same surface as the dashboard Program
         # Editor's **Options** tab. Includes reward/fraud approval, anti-fraud lists +
         # toggles, referral cookie/credit windows, reCAPTCHA, affiliate enrollment +
-        # application review, payout threshold + tax settings (affiliate only), and
-        # notification-email settings. `fraud.recaptcha.secretKey` is never returned.
+        # application review, payout threshold + tax settings (affiliate only),
+        # notification-email settings, and the program's languages.
+        # `fraud.recaptcha.secretKey` is never returned.
         sig do
           params(
             id: String,
@@ -28,6 +29,8 @@ module GrowsurfRuby
         # and `payoutThreshold`/`taxDocumentation` are affiliate-only, and affiliate
         # programs require `requireParticipantAuth: true`). `fraud.recaptcha.secretKey`
         # is write-only. `referralCreditWindowDays: null` means "never expires".
+        # Turning on `languages.additionalLanguages` requires the Business plan or
+        # higher (`403` otherwise).
         sig do
           params(
             id: String,

data/rbi/growsurf_ruby/resources/campaign/participant.rbi

@@ -34,6 +34,7 @@ module GrowsurfRuby
               GrowsurfRuby::Campaign::ParticipantUpdateParams::AffiliateStatus::OrSymbol,
             email: String,
             first_name: String,
+            language: T.nilable(GrowsurfRuby::Campaign::Language::OrSymbol),
             last_name: String,
             metadata: T::Hash[Symbol, T.anything],
             notes: String,
@@ -58,6 +59,10 @@ module GrowsurfRuby
           email: nil,
           # Body param
           first_name: nil,
+          # Body param: The language of the participant's portal and program emails. Must be
+          # one of the program's languages (see `languages` in the program options). Send the
+          # base language or `null` to use the program's base language.
+          language: nil,
           # Body param
           last_name: nil,
           # Body param: Shallow custom metadata object.
@@ -136,6 +141,7 @@ module GrowsurfRuby
             first_name: String,
             ip_address: String,
             is_affiliate: T::Boolean,
+            language: GrowsurfRuby::Campaign::Language::OrSymbol,
             last_name: String,
             metadata: T::Hash[Symbol, T.anything],
             mobile_instance_id: String,
@@ -157,6 +163,9 @@ module GrowsurfRuby
           # creates a non-affiliate without `affiliateStatus`. Existing participants are
           # returned unchanged.
           is_affiliate: nil,
+          # The language of the participant's portal and program emails. Must be one of the
+          # program's languages. Applied only when this request creates the participant.
+          language: nil,
           last_name: nil,
           # Shallow custom metadata object.
           metadata: nil,

data/rbi/growsurf_ruby/resources/campaign.rbi

@@ -209,6 +209,7 @@ module GrowsurfRuby
           fingerprint: String,
           first_name: String,
           ip_address: String,
+          language: GrowsurfRuby::Campaign::Language::OrSymbol,
           last_name: String,
           metadata: T::Hash[Symbol, T.anything],
           mobile_instance_id: String,
@@ -227,6 +228,9 @@ module GrowsurfRuby
         fingerprint: nil,
         first_name: nil,
         ip_address: nil,
+        # The language of the participant's portal and program emails. Must be one of the
+        # program's languages. Applied only when this request creates the participant.
+        language: nil,
         last_name: nil,
         # Shallow custom metadata object.
         metadata: nil,

data/sig/growsurf_ruby/models/campaign/create.rbs

@@ -8,6 +8,7 @@ module GrowsurfRuby
           first_name: String,
           ip_address: String,
           is_affiliate: bool,
+          language: GrowsurfRuby::Models::Campaign::language,
           last_name: String,
           metadata: ::Hash[Symbol, top],
           mobile_instance_id: String,
@@ -34,6 +35,12 @@ module GrowsurfRuby
 
         def is_affiliate=: (bool) -> bool
 
+        attr_reader language: GrowsurfRuby::Models::Campaign::language?
+
+        def language=: (
+          GrowsurfRuby::Models::Campaign::language
+        ) -> GrowsurfRuby::Models::Campaign::language
+
         attr_reader last_name: String?
 
         def last_name=: (String) -> String
@@ -62,6 +69,7 @@ module GrowsurfRuby
           ?first_name: String,
           ?ip_address: String,
           ?is_affiliate: bool,
+          ?language: GrowsurfRuby::Models::Campaign::language,
           ?last_name: String,
           ?metadata: ::Hash[Symbol, top],
           ?mobile_instance_id: String,
@@ -75,6 +83,7 @@ module GrowsurfRuby
           first_name: String,
           ip_address: String,
           is_affiliate: bool,
+          language: GrowsurfRuby::Models::Campaign::language,
           last_name: String,
           metadata: ::Hash[Symbol, top],
           mobile_instance_id: String,

data/sig/growsurf_ruby/models/campaign/language.rbs

@@ -0,0 +1,42 @@
+module GrowsurfRuby
+  module Models
+    module Campaign
+      type language =
+        :en
+        | :es
+        | :fr
+        | :de
+        | :it
+        | :"pt-BR"
+        | :nl
+        | :pl
+        | :sv
+        | :tr
+        | :ja
+        | :ko
+        | :"zh-CN"
+        | :id
+
+      module Language
+        extend GrowsurfRuby::Internal::Type::Enum
+
+        EN: :en
+        ES: :es
+        FR: :fr
+        DE: :de
+        IT: :it
+        PT_BR: :"pt-BR"
+        NL: :nl
+        PL: :pl
+        SV: :sv
+        TR: :tr
+        JA: :ja
+        KO: :ko
+        ZH_CN: :"zh-CN"
+        ID: :id
+
+        def self?.values: -> ::Array[GrowsurfRuby::Models::Campaign::language]
+      end
+    end
+  end
+end

data/sig/growsurf_ruby/models/campaign/participant.rbs

@@ -25,6 +25,7 @@ module GrowsurfRuby
           is_affiliate: bool,
           is_new: bool,
           is_winner: bool,
+          language: GrowsurfRuby::Models::Campaign::language,
           last_name: String?,
           lead_count: Integer,
           metadata: ::Hash[Symbol, top],
@@ -117,6 +118,12 @@ module GrowsurfRuby
 
         def is_winner=: (bool) -> bool
 
+        attr_reader language: GrowsurfRuby::Models::Campaign::language?
+
+        def language=: (
+          GrowsurfRuby::Models::Campaign::language
+        ) -> GrowsurfRuby::Models::Campaign::language
+
         attr_accessor last_name: String?
 
 
@@ -224,6 +231,7 @@ module GrowsurfRuby
           ?is_affiliate: bool,
           ?is_new: bool,
           ?is_winner: bool,
+          ?language: GrowsurfRuby::Models::Campaign::language,
           ?last_name: String?,
           ?lead_count: Integer,
           ?metadata: ::Hash[Symbol, top],
@@ -270,6 +278,7 @@ module GrowsurfRuby
           is_affiliate: bool,
           is_new: bool,
           is_winner: bool,
+          language: GrowsurfRuby::Models::Campaign::language,
           last_name: String?,
           lead_count: Integer,
           metadata: ::Hash[Symbol, top],

data/sig/growsurf_ruby/models/campaign/participant_update_params.rbs

@@ -8,6 +8,7 @@ module GrowsurfRuby
           affiliate_status: GrowsurfRuby::Models::Campaign::ParticipantUpdateParams::affiliate_status,
           email: String,
           first_name: String,
+          language: GrowsurfRuby::Models::Campaign::language?,
           last_name: String,
           metadata: ::Hash[Symbol, top],
           notes: String,
@@ -40,6 +41,8 @@ module GrowsurfRuby
 
         def first_name=: (String) -> String
 
+        attr_accessor language: GrowsurfRuby::Models::Campaign::language?
+
         attr_reader last_name: String?
 
         def last_name=: (String) -> String
@@ -76,6 +79,7 @@ module GrowsurfRuby
           ?affiliate_status: GrowsurfRuby::Models::Campaign::ParticipantUpdateParams::affiliate_status,
           ?email: String,
           ?first_name: String,
+          ?language: GrowsurfRuby::Models::Campaign::language?,
           ?last_name: String,
           ?metadata: ::Hash[Symbol, top],
           ?notes: String,
@@ -92,6 +96,7 @@ module GrowsurfRuby
           affiliate_status: GrowsurfRuby::Models::Campaign::ParticipantUpdateParams::affiliate_status,
           email: String,
           first_name: String,
+          language: GrowsurfRuby::Models::Campaign::language?,
           last_name: String,
           metadata: ::Hash[Symbol, top],
           notes: String,

data/sig/growsurf_ruby/resources/campaign/participant.rbs

@@ -14,6 +14,7 @@ module GrowsurfRuby
           ?affiliate_status: GrowsurfRuby::Models::Campaign::ParticipantUpdateParams::affiliate_status,
           ?email: String,
           ?first_name: String,
+          ?language: GrowsurfRuby::Models::Campaign::language?,
           ?last_name: String,
           ?metadata: ::Hash[Symbol, top],
           ?notes: String,
@@ -43,6 +44,7 @@ module GrowsurfRuby
           ?first_name: String,
           ?ip_address: String,
           ?is_affiliate: bool,
+          ?language: GrowsurfRuby::Models::Campaign::language,
           ?last_name: String,
           ?metadata: ::Hash[Symbol, top],
           ?mobile_instance_id: String,

data/sig/growsurf_ruby/resources/campaign.rbs

@@ -76,6 +76,7 @@ module GrowsurfRuby
         ?fingerprint: String,
         ?first_name: String,
         ?ip_address: String,
+        ?language: GrowsurfRuby::Models::Campaign::language,
         ?last_name: String,
         ?metadata: ::Hash[Symbol, top],
         ?mobile_instance_id: String,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: growsurf-ruby
 version: !ruby/object:Gem::Version
-  version: 1.11.0
+  version: 1.13.0
 platform: ruby
 authors:
 - Growsurf
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-29 00:00:00.000000000 Z
+date: 2026-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -91,6 +91,7 @@ files:
 - lib/growsurf_ruby/models/campaign/fraud_risk_level.rb
 - lib/growsurf_ruby/models/campaign/integration.rb
 - lib/growsurf_ruby/models/campaign/integration_list_response.rb
+- lib/growsurf_ruby/models/campaign/language.rb
 - lib/growsurf_ruby/models/campaign/participant.rb
 - lib/growsurf_ruby/models/campaign/participant_activation_analytics.rb
 - lib/growsurf_ruby/models/campaign/participant_activity_logs_response.rb
@@ -247,6 +248,7 @@ files:
 - rbi/growsurf_ruby/models/campaign/fraud_risk_level.rbi
 - rbi/growsurf_ruby/models/campaign/integration.rbi
 - rbi/growsurf_ruby/models/campaign/integration_list_response.rbi
+- rbi/growsurf_ruby/models/campaign/language.rbi
 - rbi/growsurf_ruby/models/campaign/participant.rbi
 - rbi/growsurf_ruby/models/campaign/participant_activation_analytics.rbi
 - rbi/growsurf_ruby/models/campaign/participant_activity_logs_response.rbi
@@ -402,6 +404,7 @@ files:
 - sig/growsurf_ruby/models/campaign/fraud_risk_level.rbs
 - sig/growsurf_ruby/models/campaign/integration.rbs
 - sig/growsurf_ruby/models/campaign/integration_list_response.rbs
+- sig/growsurf_ruby/models/campaign/language.rbs
 - sig/growsurf_ruby/models/campaign/participant.rbs
 - sig/growsurf_ruby/models/campaign/participant_activation_analytics.rbs
 - sig/growsurf_ruby/models/campaign/participant_activity_logs_response.rbs