growsurf-python 1.15.1__tar.gz → 1.17.0__tar.gz

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

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

{growsurf_python-1.15.1 → growsurf_python-1.17.0}/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [1.17.0](https://github.com/growsurf/growsurf-python/compare/v1.16.0...v1.17.0) (2026-11-03)
+
+
+### Features
+
+* add Tint and Glass program styles ([a975c13](https://github.com/growsurf/growsurf-python/commit/a975c13b267bf97ff9d57f26673f92bc29642b35))
+* **api:** add languages.flagCountries to Campaign Options ([d5663f0](https://github.com/growsurf/growsurf-python/commit/d5663f08a9fa3e4ec421a90af9b4491ba4eb6dc4))
+* **api:** sync REST v2 contract changes ([2a0e777](https://github.com/growsurf/growsurf-python/commit/2a0e7778a0bdddadbdfe7b55c225723d2c813d02))
+* expose documented error-body fields and sync campaign and participant models ([65db348](https://github.com/growsurf/growsurf-python/commit/65db34829db847313e17757832f6d8f2324535ba))
+* expose program visual style in campaign design ([0d93f91](https://github.com/growsurf/growsurf-python/commit/0d93f917180557f492016acc623cf449962b7120))
+
+
+### Bug Fixes
+
+* **deps:** bump aiohttp to 3.14.5 and certifi to 2026.10.23 for security advisories ([c9640ee](https://github.com/growsurf/growsurf-python/commit/c9640eeb58f96838f52b3b24f2168a24b5402e74))
+
+
+### Documentation
+
+* clarify Add Participant claim-offer wording and page title defaults ([5fc74e8](https://github.com/growsurf/growsurf-python/commit/5fc74e8666defb009a7870ee20701c0ce8ca0506))
+* clarify referral reward metadata amounts ([1bf9897](https://github.com/growsurf/growsurf-python/commit/1bf9897e437a67f4c912fcec24f234d24ebbf155))
+* correct default program style ([4f6bbd5](https://github.com/growsurf/growsurf-python/commit/4f6bbd5425ceb84889d14ddd70b0e2653ef94f04))
+
+## [1.16.0](https://github.com/growsurf/growsurf-python/compare/v1.15.1...v1.16.0) (2026-10-19)
+
+
+### Features
+
+* support resource empty-state graphics ([afba1c2](https://github.com/growsurf/growsurf-python/commit/afba1c2730e504d8b1410c110ddb76e4fe5551d0))
+* support resource empty-state graphics ([5898cd4](https://github.com/growsurf/growsurf-python/commit/5898cd4f8df39e538b31ee0c28363b82b0149aa4))
+
 ## [1.15.1](https://github.com/growsurf/growsurf-python/compare/v1.15.0...v1.15.1) (2026-10-19)
 
 

{growsurf_python-1.15.1 → growsurf_python-1.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: growsurf-python
-Version: 1.15.1
+Version: 1.17.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.15.1 → growsurf_python-1.17.0}/api.md

@@ -287,3 +287,22 @@ Methods:
 
 - <code title="get /campaign/{id}/installation">client.campaign.installation.<a href="./src/growsurf/resources/campaign/installation.py">retrieve</a>(id) -> <a href="./src/growsurf/types/campaign/campaign_installation.py">CampaignInstallation</a></code>
 - <code title="patch /campaign/{id}/installation">client.campaign.installation.<a href="./src/growsurf/resources/campaign/installation.py">update</a>(id, \*, body) -> <a href="./src/growsurf/types/campaign/campaign_installation.py">CampaignInstallation</a></code>
+
+## CustomDomain
+
+Types:
+
+```python
+from growsurf.types.campaign import (
+    CampaignCustomDomain,
+    CampaignCustomDomainDNSRecord,
+    DeleteCampaignCustomDomainResponse,
+)
+```
+
+Methods:
+
+- <code title="get /campaign/{id}/custom-domain">client.campaign.custom_domain.<a href="./src/growsurf/resources/campaign/custom_domain.py">retrieve</a>(id) -> <a href="./src/growsurf/types/campaign/campaign_custom_domain.py">CampaignCustomDomain</a></code>
+- <code title="put /campaign/{id}/custom-domain">client.campaign.custom_domain.<a href="./src/growsurf/resources/campaign/custom_domain.py">set</a>(id, \*\*<a href="src/growsurf/types/campaign/custom_domain_set_params.py">params</a>) -> <a href="./src/growsurf/types/campaign/campaign_custom_domain.py">CampaignCustomDomain</a></code>
+- <code title="post /campaign/{id}/custom-domain/verify">client.campaign.custom_domain.<a href="./src/growsurf/resources/campaign/custom_domain.py">verify</a>(id) -> <a href="./src/growsurf/types/campaign/campaign_custom_domain.py">CampaignCustomDomain</a></code>
+- <code title="delete /campaign/{id}/custom-domain">client.campaign.custom_domain.<a href="./src/growsurf/resources/campaign/custom_domain.py">delete</a>(id) -> <a href="./src/growsurf/types/campaign/delete_campaign_custom_domain_response.py">DeleteCampaignCustomDomainResponse</a></code>

{growsurf_python-1.15.1 → growsurf_python-1.17.0}/pyproject.toml

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

{growsurf_python-1.15.1 → growsurf_python-1.17.0}/requirements-dev.lock

@@ -9,7 +9,7 @@ anyio==4.15.1
     #   httpx
 backports-asyncio-runner==1.2.0 ; python_full_version < '3.11'
     # via pytest-asyncio
-certifi==2026.1.4
+certifi==2026.10.23
     # via
     #   httpcore
     #   httpx

growsurf_python-1.17.0/src/growsurf/_exceptions.py

@@ -0,0 +1,199 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, List, cast
+from typing_extensions import Literal
+
+import httpx
+
+__all__ = [
+    "BadRequestError",
+    "AuthenticationError",
+    "PermissionDeniedError",
+    "NotFoundError",
+    "ConflictError",
+    "UnprocessableEntityError",
+    "RateLimitError",
+    "InternalServerError",
+]
+
+
+class GrowsurfError(Exception):
+    pass
+
+
+class APIError(GrowsurfError):
+    message: str
+    request: httpx.Request
+
+    body: object | None
+    """The API response body.
+
+    If the API responded with a valid JSON structure then this property will be the
+    decoded result.
+
+    If it isn't a valid JSON structure then this will be the raw response.
+
+    If there was no response associated with this error then it will be `None`.
+    """
+
+    def __init__(self, message: str, request: httpx.Request, *, body: object | None) -> None:  # noqa: ARG002
+        super().__init__(message)
+        self.request = request
+        self.message = message
+        self.body = body
+
+
+class APIResponseValidationError(APIError):
+    response: httpx.Response
+    status_code: int
+
+    def __init__(self, response: httpx.Response, body: object | None, *, message: str | None = None) -> None:
+        super().__init__(message or "Data returned by API invalid for expected schema.", response.request, body=body)
+        self.response = response
+        self.status_code = response.status_code
+
+
+class APIStatusError(APIError):
+    """Raised when an API response has a status code of 4xx or 5xx."""
+
+    response: httpx.Response
+    status_code: int
+
+    # Documented error-body fields. Each is `None` when the body omits it or sends another
+    # type; `body` keeps the complete response body, including fields added later.
+    error_name: str | None
+    """Error name returned for the failed request."""
+
+    error_code: str | None
+    """Stable machine-readable error code."""
+
+    error_message: str | None
+    """Human-readable error message."""
+
+    errors: List[Dict[str, object]] | None
+    """Optional validation details for specific request fields."""
+
+    support_url: str | None
+    """Support URL related to the error, when available."""
+
+    policy_name: str | None
+    """Rate-limit policy name for `429` errors, when available."""
+
+    level: str | None
+    """Error severity level, when available."""
+
+    timestamp: str | None
+    """When the error response was created."""
+
+    fraud_risk_level: str | None
+    """Fraud risk level assigned to the blocked signup."""
+
+    fraud_reason_code: str | None
+    """Machine-readable reason code for the fraud decision."""
+
+    matched_participant_ids: List[str] | None
+    """Existing participant IDs related to the fraud match."""
+
+    email: str | None
+    """Email address from the blocked signup attempt."""
+
+    referrer_id: str | None
+    """Referrer participant ID supplied with the blocked signup, or `null`."""
+
+    ip_address: str | None
+    """IP address supplied with the blocked signup, or `null`."""
+
+    fingerprint: str | None
+    """Browser fingerprint supplied with the blocked signup, or `null`."""
+
+    blocked_at: str | None
+    """When the signup was blocked."""
+
+    def __init__(self, message: str, *, response: httpx.Response, body: object | None) -> None:
+        super().__init__(message, response.request, body=body)
+        self.response = response
+        self.status_code = response.status_code
+
+        fields = cast(Dict[str, object], body) if isinstance(body, dict) else {}
+        self.error_name = _str_or_none(fields.get("name"))
+        self.error_code = _str_or_none(fields.get("code"))
+        self.error_message = _str_or_none(fields.get("message"))
+        self.errors = _record_list_or_none(fields.get("errors"))
+        self.support_url = _str_or_none(fields.get("supportUrl"))
+        self.policy_name = _str_or_none(fields.get("policyName"))
+        self.level = _str_or_none(fields.get("level"))
+        self.timestamp = _str_or_none(fields.get("timestamp"))
+        self.fraud_risk_level = _str_or_none(fields.get("fraudRiskLevel"))
+        self.fraud_reason_code = _str_or_none(fields.get("fraudReasonCode"))
+        self.matched_participant_ids = _str_list_or_none(fields.get("matchedParticipantIds"))
+        self.email = _str_or_none(fields.get("email"))
+        self.referrer_id = _str_or_none(fields.get("referrerId"))
+        self.ip_address = _str_or_none(fields.get("ipAddress"))
+        self.fingerprint = _str_or_none(fields.get("fingerprint"))
+        self.blocked_at = _str_or_none(fields.get("blockedAt"))
+
+
+class APIConnectionError(APIError):
+    def __init__(self, *, message: str = "Connection error.", request: httpx.Request) -> None:
+        super().__init__(message, request, body=None)
+
+
+class APITimeoutError(APIConnectionError):
+    def __init__(self, request: httpx.Request) -> None:
+        super().__init__(message="Request timed out.", request=request)
+
+
+class BadRequestError(APIStatusError):
+    status_code: Literal[400] = 400  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class AuthenticationError(APIStatusError):
+    status_code: Literal[401] = 401  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class PermissionDeniedError(APIStatusError):
+    status_code: Literal[403] = 403  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class NotFoundError(APIStatusError):
+    status_code: Literal[404] = 404  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class ConflictError(APIStatusError):
+    status_code: Literal[409] = 409  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class UnprocessableEntityError(APIStatusError):
+    status_code: Literal[422] = 422  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class RateLimitError(APIStatusError):
+    status_code: Literal[429] = 429  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class InternalServerError(APIStatusError):
+    pass
+
+
+def _str_or_none(value: object) -> str | None:
+    return value if isinstance(value, str) else None
+
+
+def _str_list_or_none(value: object) -> List[str] | None:
+    if not isinstance(value, list):
+        return None
+    items = cast(List[object], value)
+    if not all(isinstance(item, str) for item in items):
+        return None
+    return cast(List[str], items)
+
+
+def _record_list_or_none(value: object) -> List[Dict[str, object]] | None:
+    if not isinstance(value, list):
+        return None
+    items = cast(List[object], value)
+    if not all(isinstance(item, dict) for item in items):
+        return None
+    return cast(List[Dict[str, object]], items)

{growsurf_python-1.15.1 → growsurf_python-1.17.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.15.1"  # x-release-please-version
+__version__ = "1.17.0"  # x-release-please-version

{growsurf_python-1.15.1 → growsurf_python-1.17.0}/src/growsurf/resources/campaign/__init__.py

@@ -88,6 +88,14 @@ from .integrations import (
     IntegrationsResourceWithStreamingResponse,
     AsyncIntegrationsResourceWithStreamingResponse,
 )
+from .custom_domain import (
+    CustomDomainResource,
+    AsyncCustomDomainResource,
+    CustomDomainResourceWithRawResponse,
+    AsyncCustomDomainResourceWithRawResponse,
+    CustomDomainResourceWithStreamingResponse,
+    AsyncCustomDomainResourceWithStreamingResponse,
+)
 from .program_resources import (
     ProgramResourcesResource,
     AsyncProgramResourcesResource,
@@ -158,6 +166,12 @@ __all__ = [
     "AsyncInstallationResourceWithRawResponse",
     "InstallationResourceWithStreamingResponse",
     "AsyncInstallationResourceWithStreamingResponse",
+    "CustomDomainResource",
+    "AsyncCustomDomainResource",
+    "CustomDomainResourceWithRawResponse",
+    "AsyncCustomDomainResourceWithRawResponse",
+    "CustomDomainResourceWithStreamingResponse",
+    "AsyncCustomDomainResourceWithStreamingResponse",
     "CommissionResource",
     "AsyncCommissionResource",
     "CommissionResourceWithRawResponse",

{growsurf_python-1.15.1 → growsurf_python-1.17.0}/src/growsurf/resources/campaign/campaign.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, Iterable
+from typing import Dict, Iterable, Optional
 from typing_extensions import Literal
 
 import httpx
@@ -113,6 +113,14 @@ from .integrations import (
     IntegrationsResourceWithStreamingResponse,
     AsyncIntegrationsResourceWithStreamingResponse,
 )
+from .custom_domain import (
+    CustomDomainResource,
+    AsyncCustomDomainResource,
+    CustomDomainResourceWithRawResponse,
+    AsyncCustomDomainResourceWithRawResponse,
+    CustomDomainResourceWithStreamingResponse,
+    AsyncCustomDomainResourceWithStreamingResponse,
+)
 from ..._base_client import make_request_options
 from ...types.campaign import ReferralStatus, reward_create_params
 from .program_resources import (
@@ -197,6 +205,11 @@ class CampaignResource(SyncAPIResource):
         """Campaign installation (`CampaignInstallation`) — the Program Editor's Installation tab."""
         return InstallationResource(self._client)
 
+    @cached_property
+    def custom_domain(self) -> CustomDomainResource:
+        """Campaign custom domain (`CampaignCustomDomain`) — the domain that serves a program's landing pages."""
+        return CustomDomainResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> CampaignResourceWithRawResponse:
         """
@@ -220,8 +233,8 @@ class CampaignResource(SyncAPIResource):
         self,
         *,
         type: Literal["REFERRAL", "AFFILIATE"],
-        company_logo_image_url: str | Omit = omit,
-        company_name: str | Omit = omit,
+        company_logo_image_url: Optional[str] | Omit = omit,
+        company_name: Optional[str] | Omit = omit,
         currency_iso: str | Omit = omit,
         goal: Literal[
             "CUSTOMERS",
@@ -329,8 +342,8 @@ class CampaignResource(SyncAPIResource):
         self,
         id: str,
         *,
-        company_logo_image_url: str | Omit = omit,
-        company_name: str | Omit = omit,
+        company_logo_image_url: Optional[str] | Omit = omit,
+        company_name: Optional[str] | Omit = omit,
         name: str | Omit = omit,
         status: Literal["IN_PROGRESS", "COMPLETE"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -347,8 +360,8 @@ class CampaignResource(SyncAPIResource):
         dedicated config sub-resources, not here. The program cannot be deleted via this
         endpoint.
         Changes to participant email content are checked before saving. Rejected content returns
-        `400`; if the check is unavailable, `503` asks you to retry. Neither response saves the
-        change. A concurrent edit can return `409`; reload the program before retrying.
+        `400` and is not saved. A concurrent edit can return `409`; reload the program before
+        retrying.
 
         Args:
           status: The requested program status. `IN_PROGRESS` publishes or resumes the program;
@@ -449,6 +462,7 @@ class CampaignResource(SyncAPIResource):
         metadata: Dict[str, object] | Omit = omit,
         mobile_instance_id: str | Omit = omit,
         referral_status: Literal["CREDIT_PENDING", "CREDIT_AWARDED"] | Omit = omit,
+        referred_at: Optional[int] | Omit = omit,
         referred_by: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -472,8 +486,14 @@ 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.
+          language: The language of the participant's portal and program emails. Stored when it is one of
+              the program's languages. A regional tag maps to its language (for example, `es-MX` is
+              stored as `es`). Any other value is ignored and the program's base language applies.
+              Applied only when this request creates the participant.
+
+          referred_at: When the participant was referred, in Unix milliseconds. Used only with a valid
+              `referredBy`. If you omit `referralStatus`, GrowSurf compares this time with the
+              program's referral credit window to set it. Defaults to the time of the request.
 
           referred_by: Referrer participant ID or email address.
 
@@ -501,6 +521,7 @@ class CampaignResource(SyncAPIResource):
                     "metadata": metadata,
                     "mobile_instance_id": mobile_instance_id,
                     "referral_status": referral_status,
+                    "referred_at": referred_at,
                     "referred_by": referred_by,
                 },
                 campaign_create_mobile_participant_token_params.CampaignCreateMobileParticipantTokenParams,
@@ -793,10 +814,7 @@ class CampaignResource(SyncAPIResource):
         next_id: str | Omit = omit,
         offset: int | Omit = omit,
         referral_status: ReferralStatus | Omit = omit,
-        sort_by: Literal[
-            "updatedAt", "createdAt", "email", "firstName", "lastName", "referralStatus", "referralTriggeredAt"
-        ]
-        | Omit = omit,
+        sort_by: Literal["updatedAt", "createdAt", "email", "referralTriggeredAt"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -1432,6 +1450,11 @@ class AsyncCampaignResource(AsyncAPIResource):
         """Campaign installation (`CampaignInstallation`) — the Program Editor's Installation tab."""
         return AsyncInstallationResource(self._client)
 
+    @cached_property
+    def custom_domain(self) -> AsyncCustomDomainResource:
+        """Campaign custom domain (`CampaignCustomDomain`) — the domain that serves a program's landing pages."""
+        return AsyncCustomDomainResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> AsyncCampaignResourceWithRawResponse:
         """
@@ -1455,8 +1478,8 @@ class AsyncCampaignResource(AsyncAPIResource):
         self,
         *,
         type: Literal["REFERRAL", "AFFILIATE"],
-        company_logo_image_url: str | Omit = omit,
-        company_name: str | Omit = omit,
+        company_logo_image_url: Optional[str] | Omit = omit,
+        company_name: Optional[str] | Omit = omit,
         currency_iso: str | Omit = omit,
         goal: Literal[
             "CUSTOMERS",
@@ -1564,8 +1587,8 @@ class AsyncCampaignResource(AsyncAPIResource):
         self,
         id: str,
         *,
-        company_logo_image_url: str | Omit = omit,
-        company_name: str | Omit = omit,
+        company_logo_image_url: Optional[str] | Omit = omit,
+        company_name: Optional[str] | Omit = omit,
         name: str | Omit = omit,
         status: Literal["IN_PROGRESS", "COMPLETE"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -1582,8 +1605,8 @@ class AsyncCampaignResource(AsyncAPIResource):
         dedicated config sub-resources, not here. The program cannot be deleted via this
         endpoint.
         Changes to participant email content are checked before saving. Rejected content returns
-        `400`; if the check is unavailable, `503` asks you to retry. Neither response saves the
-        change. A concurrent edit can return `409`; reload the program before retrying.
+        `400` and is not saved. A concurrent edit can return `409`; reload the program before
+        retrying.
 
         Args:
           status: The requested program status. `IN_PROGRESS` publishes or resumes the program;
@@ -1684,6 +1707,7 @@ class AsyncCampaignResource(AsyncAPIResource):
         metadata: Dict[str, object] | Omit = omit,
         mobile_instance_id: str | Omit = omit,
         referral_status: Literal["CREDIT_PENDING", "CREDIT_AWARDED"] | Omit = omit,
+        referred_at: Optional[int] | Omit = omit,
         referred_by: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -1707,8 +1731,14 @@ 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.
+          language: The language of the participant's portal and program emails. Stored when it is one of
+              the program's languages. A regional tag maps to its language (for example, `es-MX` is
+              stored as `es`). Any other value is ignored and the program's base language applies.
+              Applied only when this request creates the participant.
+
+          referred_at: When the participant was referred, in Unix milliseconds. Used only with a valid
+              `referredBy`. If you omit `referralStatus`, GrowSurf compares this time with the
+              program's referral credit window to set it. Defaults to the time of the request.
 
           referred_by: Referrer participant ID or email address.
 
@@ -1736,6 +1766,7 @@ class AsyncCampaignResource(AsyncAPIResource):
                     "metadata": metadata,
                     "mobile_instance_id": mobile_instance_id,
                     "referral_status": referral_status,
+                    "referred_at": referred_at,
                     "referred_by": referred_by,
                 },
                 campaign_create_mobile_participant_token_params.CampaignCreateMobileParticipantTokenParams,
@@ -2028,10 +2059,7 @@ class AsyncCampaignResource(AsyncAPIResource):
         next_id: str | Omit = omit,
         offset: int | Omit = omit,
         referral_status: ReferralStatus | Omit = omit,
-        sort_by: Literal[
-            "updatedAt", "createdAt", "email", "firstName", "lastName", "referralStatus", "referralTriggeredAt"
-        ]
-        | Omit = omit,
+        sort_by: Literal["updatedAt", "createdAt", "email", "referralTriggeredAt"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -2734,6 +2762,11 @@ class CampaignResourceWithRawResponse:
         """Campaign installation (`CampaignInstallation`) — the Program Editor's Installation tab."""
         return InstallationResourceWithRawResponse(self._campaign.installation)
 
+    @cached_property
+    def custom_domain(self) -> CustomDomainResourceWithRawResponse:
+        """Campaign custom domain (`CampaignCustomDomain`) — the domain that serves a program's landing pages."""
+        return CustomDomainResourceWithRawResponse(self._campaign.custom_domain)
+
 
 class AsyncCampaignResourceWithRawResponse:
     def __init__(self, campaign: AsyncCampaignResource) -> None:
@@ -2856,6 +2889,11 @@ class AsyncCampaignResourceWithRawResponse:
         """Campaign installation (`CampaignInstallation`) — the Program Editor's Installation tab."""
         return AsyncInstallationResourceWithRawResponse(self._campaign.installation)
 
+    @cached_property
+    def custom_domain(self) -> AsyncCustomDomainResourceWithRawResponse:
+        """Campaign custom domain (`CampaignCustomDomain`) — the domain that serves a program's landing pages."""
+        return AsyncCustomDomainResourceWithRawResponse(self._campaign.custom_domain)
+
 
 class CampaignResourceWithStreamingResponse:
     def __init__(self, campaign: CampaignResource) -> None:
@@ -2978,6 +3016,11 @@ class CampaignResourceWithStreamingResponse:
         """Campaign installation (`CampaignInstallation`) — the Program Editor's Installation tab."""
         return InstallationResourceWithStreamingResponse(self._campaign.installation)
 
+    @cached_property
+    def custom_domain(self) -> CustomDomainResourceWithStreamingResponse:
+        """Campaign custom domain (`CampaignCustomDomain`) — the domain that serves a program's landing pages."""
+        return CustomDomainResourceWithStreamingResponse(self._campaign.custom_domain)
+
 
 class AsyncCampaignResourceWithStreamingResponse:
     def __init__(self, campaign: AsyncCampaignResource) -> None:
@@ -3099,3 +3142,8 @@ class AsyncCampaignResourceWithStreamingResponse:
     def installation(self) -> AsyncInstallationResourceWithStreamingResponse:
         """Campaign installation (`CampaignInstallation`) — the Program Editor's Installation tab."""
         return AsyncInstallationResourceWithStreamingResponse(self._campaign.installation)
+
+    @cached_property
+    def custom_domain(self) -> AsyncCustomDomainResourceWithStreamingResponse:
+        """Campaign custom domain (`CampaignCustomDomain`) — the domain that serves a program's landing pages."""
+        return AsyncCustomDomainResourceWithStreamingResponse(self._campaign.custom_domain)