growsurf-python 1.12.0__tar.gz → 1.13.0__tar.gz

growsurf_python-1.13.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.13.0"
+}

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [1.13.0](https://github.com/growsurf/growsurf-python/compare/v1.12.0...v1.13.0) (2026-10-09)
+
+
+### Features
+
+* add program and participant language support ([57890e4](https://github.com/growsurf/growsurf-python/commit/57890e4ddfd3b2af6ac43d8caafdcf8ab013f3a6))
+* add program languages and update SDK guidance ([1925adb](https://github.com/growsurf/growsurf-python/commit/1925adb305c1ba3743dcbac397c06dfcb2444743))
+
 ## [1.12.0](https://github.com/growsurf/growsurf-python/compare/v1.11.0...v1.12.0) (2026-10-07)
 
 

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: growsurf-python
-Version: 1.12.0
+Version: 1.13.0
 Summary: The official Python library for the growsurf API
 Project-URL: Homepage, https://growsurf.com/
 Project-URL: Repository, https://github.com/growsurf/growsurf-python

growsurf_python-1.13.0/SECURITY.md

@@ -0,0 +1,13 @@
+# Security Policy
+
+## Reporting Security Issues
+
+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
+
+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
+
+For security issues in GrowSurf products or services that are not related to this SDK, contact support@growsurf.com as well.

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/api.md

@@ -105,6 +105,7 @@ Types:
 ```python
 from growsurf.types.campaign import (
     FraudRiskLevel,
+    Language,
     Participant,
     ParticipantReward,
     ReferralSource,

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "growsurf-python"
-version = "1.12.0"
+version = "1.13.0"
 description = "The official Python library for the growsurf API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/src/growsurf/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "growsurf"
-__version__ = "1.12.0"  # x-release-please-version
+__version__ = "1.13.0"  # x-release-please-version

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/src/growsurf/resources/campaign/campaign.py

@@ -127,6 +127,7 @@ from ...types.referral_list import ReferralList
 from ...types.affiliate_invite import AffiliateInvite
 from ...types.participant_list import ParticipantList
 from ...types.campaign.campaign import Campaign
+from ...types.campaign.language import Language
 from ...types.affiliate_application import AffiliateApplication
 from ...types.campaign_list_response import CampaignListResponse
 from ...types.participant_payout_list import ParticipantPayoutList
@@ -439,6 +440,7 @@ class CampaignResource(SyncAPIResource):
         first_name: str | Omit = omit,
         ip_address: str | Omit = omit,
         is_affiliate: bool | Omit = omit,
+        language: Language | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
         mobile_instance_id: str | Omit = omit,
@@ -466,6 +468,9 @@ class CampaignResource(SyncAPIResource):
 
           is_affiliate: Affiliate programs only. Controls affiliate enrollment for a new participant.
 
+          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.
+
           referred_by: Referrer participant ID or email address.
 
           extra_headers: Send extra headers
@@ -487,6 +492,7 @@ class CampaignResource(SyncAPIResource):
                     "first_name": first_name,
                     "ip_address": ip_address,
                     "is_affiliate": is_affiliate,
+                    "language": language,
                     "last_name": last_name,
                     "metadata": metadata,
                     "mobile_instance_id": mobile_instance_id,
@@ -1665,6 +1671,7 @@ class AsyncCampaignResource(AsyncAPIResource):
         first_name: str | Omit = omit,
         ip_address: str | Omit = omit,
         is_affiliate: bool | Omit = omit,
+        language: Language | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
         mobile_instance_id: str | Omit = omit,
@@ -1692,6 +1699,9 @@ class AsyncCampaignResource(AsyncAPIResource):
 
           is_affiliate: Affiliate programs only. Controls affiliate enrollment for a new participant.
 
+          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.
+
           referred_by: Referrer participant ID or email address.
 
           extra_headers: Send extra headers
@@ -1713,6 +1723,7 @@ class AsyncCampaignResource(AsyncAPIResource):
                     "first_name": first_name,
                     "ip_address": ip_address,
                     "is_affiliate": is_affiliate,
+                    "language": language,
                     "last_name": last_name,
                     "metadata": metadata,
                     "mobile_instance_id": mobile_instance_id,

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/src/growsurf/resources/campaign/participant.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Any, Dict, Iterable, cast
+from typing import Any, Dict, Iterable, Optional, cast
 from typing_extensions import Literal
 
 import httpx
@@ -37,6 +37,7 @@ from ...types.campaign import (
     participant_request_payout_destination_confirmation_params,
 )
 from ...types.referral_list import ReferralList
+from ...types.campaign.language import Language
 from ...types.campaign.participant import Participant
 from ...types.participant_payout_list import ParticipantPayoutList
 from ...types.campaign.referral_status import ReferralStatus
@@ -129,6 +130,7 @@ class ParticipantResource(SyncAPIResource):
         affiliate_status: Literal["APPROVED", "SUSPENDED", "BANNED"] | Omit = omit,
         email: str | Omit = omit,
         first_name: str | Omit = omit,
+        language: Optional[Language] | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
         notes: str | Omit = omit,
@@ -155,6 +157,10 @@ class ParticipantResource(SyncAPIResource):
               participant who is not yet an affiliate. `SUSPENDED` and `BANNED` are rejected for
               non-affiliates.
 
+          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.
+
           metadata: Shallow custom metadata object.
 
           notes: Freeform internal notes about the participant (internal only, never exposed to
@@ -185,6 +191,7 @@ class ParticipantResource(SyncAPIResource):
                     "affiliate_status": affiliate_status,
                     "email": email,
                     "first_name": first_name,
+                    "language": language,
                     "last_name": last_name,
                     "metadata": metadata,
                     "notes": notes,
@@ -298,6 +305,7 @@ class ParticipantResource(SyncAPIResource):
         first_name: str | Omit = omit,
         ip_address: str | Omit = omit,
         is_affiliate: bool | Omit = omit,
+        language: Language | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
         mobile_instance_id: str | Omit = omit,
@@ -326,6 +334,9 @@ class ParticipantResource(SyncAPIResource):
               non-affiliate without `affiliateStatus`. Existing participants are returned
               unchanged.
 
+          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.
+
           metadata: Shallow custom metadata object.
 
           mobile_instance_id: Optional app-install scoped identifier for native mobile anti-fraud. Recommended
@@ -358,6 +369,7 @@ class ParticipantResource(SyncAPIResource):
                     "first_name": first_name,
                     "ip_address": ip_address,
                     "is_affiliate": is_affiliate,
+                    "language": language,
                     "last_name": last_name,
                     "metadata": metadata,
                     "mobile_instance_id": mobile_instance_id,
@@ -1019,7 +1031,7 @@ class ParticipantResource(SyncAPIResource):
         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.
 
         Args:
@@ -1397,6 +1409,7 @@ class AsyncParticipantResource(AsyncAPIResource):
         affiliate_status: Literal["APPROVED", "SUSPENDED", "BANNED"] | Omit = omit,
         email: str | Omit = omit,
         first_name: str | Omit = omit,
+        language: Optional[Language] | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
         notes: str | Omit = omit,
@@ -1423,6 +1436,10 @@ class AsyncParticipantResource(AsyncAPIResource):
               participant who is not yet an affiliate. `SUSPENDED` and `BANNED` are rejected for
               non-affiliates.
 
+          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.
+
           metadata: Shallow custom metadata object.
 
           notes: Freeform internal notes about the participant (internal only, never exposed to
@@ -1453,6 +1470,7 @@ class AsyncParticipantResource(AsyncAPIResource):
                     "affiliate_status": affiliate_status,
                     "email": email,
                     "first_name": first_name,
+                    "language": language,
                     "last_name": last_name,
                     "metadata": metadata,
                     "notes": notes,
@@ -1566,6 +1584,7 @@ class AsyncParticipantResource(AsyncAPIResource):
         first_name: str | Omit = omit,
         ip_address: str | Omit = omit,
         is_affiliate: bool | Omit = omit,
+        language: Language | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
         mobile_instance_id: str | Omit = omit,
@@ -1594,6 +1613,9 @@ class AsyncParticipantResource(AsyncAPIResource):
               non-affiliate without `affiliateStatus`. Existing participants are returned
               unchanged.
 
+          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.
+
           metadata: Shallow custom metadata object.
 
           mobile_instance_id: Optional app-install scoped identifier for native mobile anti-fraud. Recommended
@@ -1626,6 +1648,7 @@ class AsyncParticipantResource(AsyncAPIResource):
                     "first_name": first_name,
                     "ip_address": ip_address,
                     "is_affiliate": is_affiliate,
+                    "language": language,
                     "last_name": last_name,
                     "metadata": metadata,
                     "mobile_instance_id": mobile_instance_id,
@@ -2287,7 +2310,7 @@ class AsyncParticipantResource(AsyncAPIResource):
         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.
 
         Args:

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/src/growsurf/resources/campaign/reward.py

@@ -58,8 +58,8 @@ class RewardResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RewardDeleteResponse:
         """
-        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.
 
         Args:
           extra_headers: Send extra headers
@@ -96,7 +96,7 @@ class RewardResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RewardApproveResponse:
         """
-        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`.
 
@@ -196,8 +196,8 @@ class AsyncRewardResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RewardDeleteResponse:
         """
-        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.
 
         Args:
           extra_headers: Send extra headers
@@ -234,7 +234,7 @@ class AsyncRewardResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RewardApproveResponse:
         """
-        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`.
 

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/src/growsurf/types/campaign/__init__.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from .reward import Reward as Reward
 from .webhook import Webhook as Webhook
 from .campaign import Campaign as Campaign
+from .language import Language as Language
 from .integration import Integration as Integration
 from .participant import Participant as Participant
 from .webhook_event import WebhookEvent as WebhookEvent

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/src/growsurf/types/campaign/campaign_options.py

@@ -8,8 +8,9 @@ __all__ = ["CampaignOptions"]
 # A program's options (the dashboard Program Editor's Options tab): reward/fraud
 # approval, anti-fraud lists + toggles, the `LAST_CLICK` or `FIRST_CLICK`
 # attribution model, referral windows, reCAPTCHA, affiliate enrollment +
-# application review, payout + tax settings (affiliate only), and notification-
-# email settings. It is intentionally modeled as a loose object. To see the full
+# application review, payout + tax settings (affiliate only), notification-email
+# settings, and the program's `languages` (`baseLanguage` and
+# `additionalLanguages`). It is intentionally modeled as a loose object. To see the full
 # object with every field and its current value, `GET` the resource, then `PATCH`
 # back only the fields you want to change.
 CampaignOptions: TypeAlias = Dict[str, object]

growsurf_python-1.13.0/src/growsurf/types/campaign/language.py

@@ -0,0 +1,9 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["Language"]
+
+# A language a program can run in. Participants see the portal and receive program
+# emails in their language.
+Language: TypeAlias = Literal["en", "es", "fr", "de", "it", "pt-BR", "nl", "pl", "sv", "tr", "ja", "ko", "zh-CN", "id"]

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/src/growsurf/types/campaign/participant.py

@@ -5,6 +5,7 @@ from typing_extensions import Literal
 
 from pydantic import Field as FieldInfo
 
+from .language import Language
 from ..._models import BaseModel
 from .referral_source import ReferralSource
 from .referral_status import ReferralStatus
@@ -149,6 +150,13 @@ class Participant(BaseModel):
 
     is_winner: Optional[bool] = FieldInfo(alias="isWinner", default=None)
 
+    language: Optional[Language] = None
+    """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.
+    """
+
     last_name: Optional[str] = FieldInfo(alias="lastName", default=None)
 
     lead_count: Optional[int] = FieldInfo(alias="leadCount", default=None)

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/src/growsurf/types/campaign/participant_add_params.py

@@ -6,6 +6,7 @@ from typing import Dict
 from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from ..._utils import PropertyInfo
+from .language import Language
 
 __all__ = ["ParticipantAddParams"]
 
@@ -27,6 +28,13 @@ class ParticipantAddParams(TypedDict, total=False):
     unchanged.
     """
 
+    language: 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.
+    """
+
     last_name: Annotated[str, PropertyInfo(alias="lastName")]
 
     metadata: Dict[str, object]

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/src/growsurf/types/campaign/participant_update_params.py

@@ -2,11 +2,12 @@
 
 from __future__ import annotations
 
-from typing import Dict
+from typing import Dict, Optional
 from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from ..._types import SequenceNotStr
 from ..._utils import PropertyInfo
+from .language import Language
 
 __all__ = ["ParticipantUpdateParams"]
 
@@ -25,6 +26,13 @@ class ParticipantUpdateParams(TypedDict, total=False):
 
     first_name: Annotated[str, PropertyInfo(alias="firstName")]
 
+    language: Optional[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.
+    """
+
     last_name: Annotated[str, PropertyInfo(alias="lastName")]
 
     metadata: Dict[str, object]

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/src/growsurf/types/campaign_create_mobile_participant_token_params.py

@@ -6,6 +6,7 @@ from typing import Dict
 from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from .._utils import PropertyInfo
+from .campaign.language import Language
 
 __all__ = ["CampaignCreateMobileParticipantTokenParams"]
 
@@ -27,6 +28,13 @@ class CampaignCreateMobileParticipantTokenParams(TypedDict, total=False):
     unchanged.
     """
 
+    language: 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.
+    """
+
     last_name: Annotated[str, PropertyInfo(alias="lastName")]
 
     metadata: Dict[str, object]

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/tests/api_resources/campaign/test_participant.py

@@ -104,6 +104,7 @@ class TestParticipant:
             id="id",
             email="dev@stainless.com",
             first_name="Gavin",
+            language="es",
             last_name="Belson",
             metadata={"company": "bar"},
             notes="notes",
@@ -278,6 +279,7 @@ class TestParticipant:
             first_name="firstName",
             ip_address="ipAddress",
             is_affiliate=True,
+            language="es",
             last_name="lastName",
             metadata={"foo": "bar"},
             mobile_instance_id="mobileInstanceId",
@@ -1344,6 +1346,7 @@ class TestAsyncParticipant:
             id="id",
             email="dev@stainless.com",
             first_name="Gavin",
+            language="es",
             last_name="Belson",
             metadata={"company": "bar"},
             notes="notes",
@@ -1518,6 +1521,7 @@ class TestAsyncParticipant:
             first_name="firstName",
             ip_address="ipAddress",
             is_affiliate=True,
+            language="es",
             last_name="lastName",
             metadata={"foo": "bar"},
             mobile_instance_id="mobileInstanceId",

{growsurf_python-1.12.0 → growsurf_python-1.13.0}/tests/api_resources/test_campaign.py

@@ -318,6 +318,7 @@ class TestCampaign:
             fingerprint="fingerprint",
             first_name="firstName",
             ip_address="ipAddress",
+            language="es",
             last_name="lastName",
             metadata={"foo": "bar"},
             mobile_instance_id="mobileInstanceId",
@@ -1382,6 +1383,7 @@ class TestAsyncCampaign:
             fingerprint="fingerprint",
             first_name="firstName",
             ip_address="ipAddress",
+            language="es",
             last_name="lastName",
             metadata={"foo": "bar"},
             mobile_instance_id="mobileInstanceId",

growsurf_python-1.12.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "1.12.0"
-}

growsurf_python-1.12.0/SECURITY.md

@@ -1,23 +0,0 @@
-# Security Policy
-
-## 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.
-
-## 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.
-
----
-
-Thank you for helping us keep the SDKs and systems they interact with secure.