> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt # GetMarketingSettingsDefaults # Package: marketingPlan # Namespace: MarketingSettingsService # Method link: https://dev.wix.com/docs/api-reference/business-management/marketing/marketing-plan/marketing-settings-v1/get-marketing-settings-defaults.md ## Permission Scopes: Manage Marketing Plans: SCOPE.PROMOTE.MANAGE-MARKETING-PLAN ## Introduction Retrieves the default marketing settings applied when a site hasn't configured its own preferences. Use `field_mask` on the request to limit which defaults are returned. Accepted values are: `socialChannels`, `calendar`, `marketingPlanGoal`, and `frequency`. Any other value returns an error. --- ## REST API ### Schema ``` Method: getMarketingSettingsDefaults Description: Retrieves the default marketing settings applied when a site hasn't configured its own preferences. Use `field_mask` on the request to limit which defaults are returned. Accepted values are: `socialChannels`, `calendar`, `marketingPlanGoal`, and `frequency`. Any other value returns an error. URL: https://www.wixapis.com/promote/marketing-plan-service/v1/marketing-settings/defaults Method: GET Method parameters: query param name: fieldMask | type: array | description: Dot-notation field paths to limit which defaults are returned. Omit to return all defaults. Accepted values: `socialChannels`, `calendar`, `marketingPlanGoal`, `frequency`. Any other value returns an error. | validation: maxItems 50, maxLength 100 Return type: GetMarketingSettingsDefaultsResponse - name: defaults | type: MarketingSettingsDefaults | description: The default settings applied when a site hasn't configured its own preferences. - name: socialChannels | type: array | description: Default social channels included in a new marketing plan. | validation: minItems 0, maxItems 10 - enum: - FACEBOOK: Facebook. - INSTAGRAM: Instagram. - LINKEDIN: LinkedIn. - TWITTER: Deprecated: No longer functional as of July 31, 2026. - PINTEREST: Pinterest. - GBP: Google Business Profile. - TIKTOK: TikTok. - name: calendar | type: Calendar | description: Default calendars whose events are considered when planning activities. - name: ids | type: array | description: IDs of the selected calendar options. | validation: minItems 0, maxItems 20, format GUID - name: marketingPlanGoal | type: MarketingPlanGoal | description: Default marketing plan goal. - ONE-OF: - name: goalKey | type: PlanGoal | description: A standard goal selected from the available plan goal options. - enum: - DRIVE_TRAFFIC: Increase visits to the site. - BRAND_AWARENESS: Grow recognition and reach of the brand. - BOOST_SALES: Promote products or services to increase purchases. - COLLECT_LEADS: Capture contact information from potential customers. - name: customGoal | type: string | description: A free-text goal provided when none of the standard options apply. | validation: maxLength 400 - name: frequency | type: MarketingSettingsFrequencies | description: Default posting frequencies, broken down by marketing tool. - name: socialMarketing | type: Frequency | description: Default posting cadence for social marketing. - name: interval | type: Interval | description: Time unit for the posting cadence (`WEEK`, `MONTH`, or `YEAR`). - enum: - WEEK: Per-week cadence. - MONTH: Per-month cadence. - YEAR: Per-year cadence. - name: count | type: integer | description: Number of posts to produce within each `interval`. | validation: minimum 1, maximum 30, format int32 - name: blog | type: Frequency | description: Default posting cadence for blogs. - name: emailMarketing | type: Frequency | description: Default posting cadence for email marketing. ``` ### Examples ### Get marketing settings defaults Retrieve recommended default values for marketing settings. The optional fieldMask accepts only these values - socialChannels, calendar, marketingPlanGoal, frequency. Here it requests socialChannels and frequency. ```curl curl -X GET \ 'https://www.wixapis.com/promote/marketing-plan-service/v1/marketing-settings/defaults?fieldMask=socialChannels&fieldMask=frequency' \ -H 'Authorization: ' ``` --- ## JavaScript SDK ### Schema ``` Method: wixClientAdmin.promoteGrowthToolsMarketingPlan.marketingSettings.getMarketingSettingsDefaults(options) Description: Retrieves the default marketing settings applied when a site hasn't configured its own preferences. Use `field_mask` on the request to limit which defaults are returned. Accepted values are: `socialChannels`, `calendar`, `marketingPlanGoal`, and `frequency`. Any other value returns an error. Method parameters: param name: options | type: GetMarketingSettingsDefaultsOptions none - name: fieldMask | type: array | description: Dot-notation field paths to limit which defaults are returned. Omit to return all defaults. Accepted values: `socialChannels`, `calendar`, `marketingPlanGoal`, `frequency`. Any other value returns an error. | validation: maxItems 50, maxLength 100 Return type: PROMISE - name: defaults | type: MarketingSettingsDefaults | description: The default settings applied when a site hasn't configured its own preferences. - name: socialChannels | type: array | description: Default social channels included in a new marketing plan. | validation: minItems 0, maxItems 10 - enum: - FACEBOOK: Facebook. - INSTAGRAM: Instagram. - LINKEDIN: LinkedIn. - TWITTER: Deprecated: No longer functional as of July 31, 2026. - PINTEREST: Pinterest. - GBP: Google Business Profile. - TIKTOK: TikTok. - name: calendar | type: Calendar | description: Default calendars whose events are considered when planning activities. - name: ids | type: array | description: IDs of the selected calendar options. | validation: minItems 0, maxItems 20, format GUID - name: marketingPlanGoal | type: MarketingPlanGoal | description: Default marketing plan goal. - ONE-OF: - name: goalKey | type: PlanGoal | description: A standard goal selected from the available plan goal options. - enum: - DRIVE_TRAFFIC: Increase visits to the site. - BRAND_AWARENESS: Grow recognition and reach of the brand. - BOOST_SALES: Promote products or services to increase purchases. - COLLECT_LEADS: Capture contact information from potential customers. - name: customGoal | type: string | description: A free-text goal provided when none of the standard options apply. | validation: maxLength 400 - name: frequency | type: MarketingSettingsFrequencies | description: Default posting frequencies, broken down by marketing tool. - name: socialMarketing | type: Frequency | description: Default posting cadence for social marketing. - name: interval | type: Interval | description: Time unit for the posting cadence (`WEEK`, `MONTH`, or `YEAR`). - enum: - WEEK: Per-week cadence. - MONTH: Per-month cadence. - YEAR: Per-year cadence. - name: count | type: integer | description: Number of posts to produce within each `interval`. | validation: minimum 1, maximum 30, format int32 - name: blog | type: Frequency | description: Default posting cadence for blogs. - name: emailMarketing | type: Frequency | description: Default posting cadence for email marketing. ``` ### Examples ### Get marketing settings defaults fieldMask accepts only socialChannels, calendar, marketingPlanGoal, frequency. ```javascript import { marketingSettings } from "@wix/promote-growth-tools-marketing-plan"; const options = { fieldMask: ["socialChannels", "frequency"], }; async function getMarketingSettingsDefaults() { const response = await marketingSettings.getMarketingSettingsDefaults(options); } /* Promise resolves to: * { * "defaults": { * "socialChannels": [ * "INSTAGRAM", * "FACEBOOK" * ], * "frequency": { * "socialMarketing": { * "interval": "WEEK", * "count": 3 * }, * "blog": { * "interval": "WEEK", * "count": 1 * }, * "emailMarketing": { * "interval": "MONTH", * "count": 2 * } * } * } * } */ ``` ### getMarketingSettingsDefaults (self-hosted) Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md). ```javascript import { createClient } from '@wix/sdk'; import { marketingSettings } from '@wix/promote-growth-tools-marketing-plan'; // Import the auth strategy for the relevant access type // Import the relevant host module if needed const myWixClient = createClient ({ modules: { marketingSettings }, // Include the auth strategy and host as relevant }); async function getMarketingSettingsDefaults(options) { const response = await myWixClient.marketingSettings.getMarketingSettingsDefaults(options); }; ``` ---