Get Program Options
growsurf_get_campaign_optionsRetrieve a GrowSurf program's Options tab configuration—referral triggers, anti-fraud lists, affiliate settings, notifications, languages, and behavior options—to inspect current values before updating.
Instructions
Fetch the Options tab configuration for your GrowSurf program (referral triggers, anti-fraud lists and toggles, affiliate enrollment and application review, notifications, the program's languages under languages, and other behavior options). languages.baseLanguageTranslation is read-only: it counts Program Editor text that is not in a non-English base language yet, which the customer can translate from Options > Languages in the dashboard. Returns the full object with every field and its current value, the same shape you send back on update. autoFulfillRewards: false permits manual fulfillment and does not prove that any reward went undelivered. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"campaignId": "<campaignId>"
},
"name": "growsurf_get_campaign_options"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| campaignId | Yes | Target program id for this call: the `id` returned by `growsurf_list_campaigns`, not the program name or a share URL. Defaults to GROWSURF_CAMPAIGN_ID when omitted. Program IDs also identify newly created programs without restarting the server. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fraud | No | Anti-fraud settings: `blockedEmails`/`blockedIps`/`blockedCountries` and matching allow lists, `blockBurnerEmails`, `blockDataCenterIps`, `blockHighRiskReferrers`, `autoBlockHighRiskIps`, per-IP signup rate limits, and `recaptcha`. | |
| languages | No | The languages the program runs in. Participants see the portal and program emails in their language. Translations are managed in the dashboard. | |
| autoBlockFraud | No | Automatically block signups flagged as high fraud risk. | |
| rewardEvidence | No | What this response establishes about rewards. Combine with other reads; unknown here does not override evidence elsewhere. | |
| payoutThreshold | No | Affiliate programs only. Minimum payout in minor currency units (e.g. cents). `0` or `null` means no minimum. | |
| attributionModel | No | Selects which server-verified visit receives conversion credit within `referralCookieWindowDays`. `LAST_CLICK` is used when this field is missing, including for programs created before attribution models were configurable. | |
| taxDocumentation | No | Affiliate programs only. Company billing details (name, address, VAT number) used on affiliate payout invoices and for VAT handling. | |
| autoFulfillRewards | No | Referral programs only. Automatically mark earned rewards as fulfilled. `false` permits manual fulfillment and does not establish a delivery failure. | |
| notificationEmails | No | Owner notification settings: `recipients` plus per-event `events` toggles. | |
| blockPaidAdsTraffic | No | Do not attribute referrals from visitors who arrived through paid ads. | |
| enforceGdprCompliance | No | Store only the minimum participant data (no IP addresses, fingerprints, or mobile instance ids). | |
| requireParticipantAuth | No | Require returning participants to authenticate. Affiliate programs require `true`. | |
| affiliateApplicationMode | No | Affiliate programs only. How public signups join the program. `OPEN_ENROLLMENT` enrolls them directly; `MANUAL_REVIEW` collects an application you approve or deny; `AUTO_APPROVE` collects the application and approves it immediately. Switching to a reviewed mode requires a saved Program Page. Enrollment through the API, CSV import, dashboard, or invites is never blocked by this setting. | |
| referralCookieWindowDays | No | How long a referral-link click is remembered in the visitor's browser, in days. | |
| referralCreditWindowDays | No | How long a referred friend has to complete the qualifying action, in days. `null` means the credit never expires. | |
| requireManualFraudApproval | No | Flag suspected fraud for review instead of blocking signups automatically. | |
| requireManualRewardApproval | No | Referral programs only. Hold each earned reward for manual approval before it unlocks. | |
| affiliateReapplicationPolicy | No | Affiliate programs only. Whether a denied applicant may apply again. `AFTER_COOLDOWN` (the default) allows a new application once `affiliateReapplicationCooldownDays` has passed; `DISABLED` never allows one. | |
| affiliateReapplicationCooldownDays | No | Affiliate programs only. How many days a denied applicant waits before they can apply again (1-365, default 30). Only used when `affiliateReapplicationPolicy` is `AFTER_COOLDOWN`. | |
| affiliateApplicationReviewEstimateBusinessDays | No | Affiliate programs only. Optional review-time expectation shown to pending applicants, in business days (1-60). `null` clears it. |