> 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 # CreateMarketingActivity # Package: marketingPlan # Namespace: MarketingActivityService # Method link: https://dev.wix.com/docs/api-reference/business-management/marketing/marketing-plan/marketing-activity-v1/create-marketing-activity.md ## Permission Scopes: Manage Marketing Plans: SCOPE.PROMOTE.MANAGE-MARKETING-PLAN ## Introduction Creates a marketing activity. Required fields: `title`, `description`, `targetDate`, and `marketingActivityType` (must be set and not `UNKNOWN`; one of `SOCIAL_MARKETING`, `EMAIL_MARKETING`, or `BLOG`). Missing any of these returns a `FAILED_PRECONDITION` error. --- ## REST API ### Schema ``` Method: createMarketingActivity Description: Creates a marketing activity. Required fields: `title`, `description`, `targetDate`, and `marketingActivityType` (must be set and not `UNKNOWN`; one of `SOCIAL_MARKETING`, `EMAIL_MARKETING`, or `BLOG`). Missing any of these returns a `FAILED_PRECONDITION` error. URL: https://www.wixapis.com/promote/marketing-plan-service/v1/marketing-activity Method: POST # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: marketingActivity Method parameters: param name: marketingActivity | type: MarketingActivity | description: A single planned marketing action within a site's marketing plan. Activities are generated by the AI when a marketing plan is created and represent concrete tasks such as a social media campaign, a blog post, or an email. Each activity has a title, description, target date, and type. Generating social posts for an activity is handled by the separate Marketing Plan API, not this API. | required: true - name: blogSeoData | type: BlogPostCandidate | description: SEO blog candidate data associated with this activity. Present only when `marketing_activity_type` is `BLOG`. - name: candidateData | type: CandidateData | description: ids of the blog post candidate - name: briefData | type: BriefData | description: data to use to generate blog post seo brief - name: h1Title | type: string | description: title of the blog post | validation: maxLength 1000 - name: keyword | type: string | description: relevant keyword for the blog post | validation: maxLength 1000 - name: mainKeyword | type: string | description: main keyword for the blog post | validation: maxLength 1000 - name: serpData | type: SerpData | description: serp data for the main keyword - name: peopleAlsoAskSuggestions | type: array | description: list of people also ask questions | validation: maxItems 4 - name: question | type: string | description: people also ask question title | validation: maxLength 10000 - name: answers | type: array | description: answers to the question | validation: maxItems 2 - name: title | type: string | description: people also ask answer title | validation: maxLength 10000 - name: description | type: string | description: description of the answer | validation: maxLength 10000 - name: peopleAlsoSearchSuggestions | type: array | description: list of related searches | validation: maxItems 10, maxLength 10000 - name: autocompleteSuggestions | type: array | description: list of autocomplete suggestions | validation: maxItems 15, maxLength 10000 - name: pageUrl | type: string | description: related landing page | validation: maxLength 1000 - name: seoData | type: SeoSchema | description: seo data - name: tags | type: array | description: SEO tag information. - name: type | type: string | description: SEO tag type. Supported values: `title`, `meta`, `script`, `link`. - name: props | type: object | description: A `{"key": "value"}` pair object where each SEO tag property (`"name"`, `"content"`, `"rel"`, `"href"`) contains a value. For example: `{"name": "description", "content": "the description itself"}`. - name: meta | type: object | description: SEO tag metadata. For example, `{"height": 300, "width": 240}`. - name: children | type: string | description: SEO tag inner content. For example, ` inner content `. - name: custom | type: boolean | description: Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages). - name: disabled | type: boolean | description: Whether the tag is disabled. If the tag is disabled, people can't find your page when searching for this phrase in search engines. - name: settings | type: Settings | description: SEO general settings. - name: preventAutoRedirect | type: boolean | description: Whether the [automatical redirect visits](https://support.wix.com/en/article/customizing-your-pages-seo-settings-in-the-seo-panel) from the old URL to the new one is enabled. Default: `false` (automatical redirect is enabled). - name: keywords | type: array | description: User-selected keyword terms for a specific page. | validation: maxItems 5 - name: term | type: string | description: Keyword value. - name: isMain | type: boolean | description: Whether the keyword is the main focus keyword. - name: origin | type: string | description: The source that added the keyword terms to the SEO settings. | validation: maxLength 1000 - name: marketingActivityType | type: ActivityType | description: Category of marketing action this activity represents. - enum: - SOCIAL_MARKETING: Activity targets social media channels (e.g. Facebook, Instagram). - EMAIL_MARKETING: Activity targets an email campaign. - BLOG: Activity targets a blog post. - name: title | type: string | description: Short label for the activity, suitable for display in a marketing plan UI. | validation: maxLength 3000 - name: description | type: string | description: Human-readable explanation of what the activity involves and why it was suggested. | validation: maxLength 3000 - name: targetDate | type: string | description: Scheduled date by which the activity should be completed or published. | validation: format date-time - name: source | type: ActivitySource | description: Origin context that the AI used when generating this activity (for example, an upcoming event or a set of keywords). - name: type | type: ActivitySourceType | description: Indicates what kind of input drove the AI to generate this activity. - enum: - EVENT: Activity was generated based on a site event. - KEYWORDS: Activity was generated based on SEO or topic keywords. - CONTENT_PILLARS: Activity was generated based on the site's content pillars. - name: value | type: string | description: The specific value of the source input (for example, an event name or a keyword string). | validation: maxLength 3000 - name: asset | type: AssetReference | description: Site asset this activity is grounded in. - name: type | type: Type | description: Type of the site asset (for example, product or blog post). See `SiteAsset.Type` for the closed set of values. - enum: - BLOG_POST: A Wix Blog post. - EVENT: A Wix Events event. - STORES_PRODUCT: A Wix Stores product. - BOOKINGS_SERVICE: A Wix Bookings service. - STORES_COUPON: A Wix Stores coupon. - STORES_CATEGORY: A Wix Stores category. - name: id | type: string | description: GUID of the asset within its provider's data store. | validation: maxLength 256 - name: name | type: string | description: Display name of the asset (for example, the product title or blog post title), cached at activity-generation time. | validation: maxLength 3000 Return type: CreateMarketingActivityResponse - name: marketingActivity | type: MarketingActivity | description: The newly created marketing activity, including its server-assigned `id`. - ONE-OF: - name: blogSeoData | type: BlogPostCandidate | description: SEO blog candidate data associated with this activity. Present only when `marketing_activity_type` is `BLOG`. - name: id | type: string | description: blog post candidate id | validation: format GUID - name: candidateData | type: CandidateData | description: ids of the blog post candidate - name: blogPostCandidateId | type: string | description: id of the blog post topic | validation: format GUID - name: contentPlanFlowId | type: string | description: id of the content plan flow this blog post candidate belongs to | validation: format GUID - name: briefData | type: BriefData | description: data to use to generate blog post seo brief - name: h1Title | type: string | description: title of the blog post | validation: maxLength 1000 - name: keyword | type: string | description: relevant keyword for the blog post | validation: maxLength 1000 - name: mainKeyword | type: string | description: main keyword for the blog post | validation: maxLength 1000 - name: serpData | type: SerpData | description: serp data for the main keyword - name: id | type: string | description: SerpDataResult GUID | validation: format GUID - name: peopleAlsoAskSuggestions | type: array | description: list of people also ask questions | validation: maxItems 4 - name: question | type: string | description: people also ask question title | validation: maxLength 10000 - name: answers | type: array | description: answers to the question | validation: maxItems 2 - name: title | type: string | description: people also ask answer title | validation: maxLength 10000 - name: description | type: string | description: description of the answer | validation: maxLength 10000 - name: peopleAlsoSearchSuggestions | type: array | description: list of related searches | validation: maxItems 10, maxLength 10000 - name: autocompleteSuggestions | type: array | description: list of autocomplete suggestions | validation: maxItems 15, maxLength 10000 - name: pageUrl | type: string | description: related landing page | validation: maxLength 1000 - name: seoData | type: SeoSchema | description: seo data - name: tags | type: array | description: SEO tag information. - name: type | type: string | description: SEO tag type. Supported values: `title`, `meta`, `script`, `link`. - name: props | type: object | description: A `{"key": "value"}` pair object where each SEO tag property (`"name"`, `"content"`, `"rel"`, `"href"`) contains a value. For example: `{"name": "description", "content": "the description itself"}`. - name: meta | type: object | description: SEO tag metadata. For example, `{"height": 300, "width": 240}`. - name: children | type: string | description: SEO tag inner content. For example, ` inner content `. - name: custom | type: boolean | description: Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages). - name: disabled | type: boolean | description: Whether the tag is disabled. If the tag is disabled, people can't find your page when searching for this phrase in search engines. - name: settings | type: Settings | description: SEO general settings. - name: preventAutoRedirect | type: boolean | description: Whether the [automatical redirect visits](https://support.wix.com/en/article/customizing-your-pages-seo-settings-in-the-seo-panel) from the old URL to the new one is enabled. Default: `false` (automatical redirect is enabled). - name: keywords | type: array | description: User-selected keyword terms for a specific page. | validation: maxItems 5 - name: term | type: string | description: Keyword value. - name: isMain | type: boolean | description: Whether the keyword is the main focus keyword. - name: origin | type: string | description: The source that added the keyword terms to the SEO settings. | validation: maxLength 1000 - name: id | type: string | description: Unique activity GUID. Assigned on creation and read-only afterwards. | validation: format GUID - name: marketingActivityType | type: ActivityType | description: Category of marketing action this activity represents. - enum: - SOCIAL_MARKETING: Activity targets social media channels (e.g. Facebook, Instagram). - EMAIL_MARKETING: Activity targets an email campaign. - BLOG: Activity targets a blog post. - name: title | type: string | description: Short label for the activity, suitable for display in a marketing plan UI. | validation: maxLength 3000 - name: description | type: string | description: Human-readable explanation of what the activity involves and why it was suggested. | validation: maxLength 3000 - name: targetDate | type: string | description: Scheduled date by which the activity should be completed or published. | validation: format date-time - name: source | type: ActivitySource | description: Origin context that the AI used when generating this activity (for example, an upcoming event or a set of keywords). - name: type | type: ActivitySourceType | description: Indicates what kind of input drove the AI to generate this activity. - enum: - EVENT: Activity was generated based on a site event. - KEYWORDS: Activity was generated based on SEO or topic keywords. - CONTENT_PILLARS: Activity was generated based on the site's content pillars. - name: value | type: string | description: The specific value of the source input (for example, an event name or a keyword string). | validation: maxLength 3000 - name: asset | type: AssetReference | description: Site asset this activity is grounded in. - name: type | type: Type | description: Type of the site asset (for example, product or blog post). See `SiteAsset.Type` for the closed set of values. - enum: - BLOG_POST: A Wix Blog post. - EVENT: A Wix Events event. - STORES_PRODUCT: A Wix Stores product. - BOOKINGS_SERVICE: A Wix Bookings service. - STORES_COUPON: A Wix Stores coupon. - STORES_CATEGORY: A Wix Stores category. - name: id | type: string | description: GUID of the asset within its provider's data store. | validation: maxLength 256 - name: name | type: string | description: Display name of the asset (for example, the product title or blog post title), cached at activity-generation time. | validation: maxLength 3000 ``` ### Examples ### Create a social marketing activity Create a marketing activity that schedules a social media campaign for a target date. ```curl curl -X POST \ 'https://www.wixapis.com/promote/marketing-plan-service/v1/marketing-activity' \ -H 'Authorization: ' \ -H 'Content-Type: application/json' \ -d '{ "marketingActivity": { "title": "Summer Sale Instagram Campaign", "description": "Promote the summer collection with a series of Instagram posts highlighting new arrivals and seasonal discounts.", "targetDate": "2026-07-15T09:00:00.000Z", "marketingActivityType": "SOCIAL_MARKETING" } }' ``` --- ## JavaScript SDK ### Schema ``` Method: wixClientAdmin.promoteGrowthToolsMarketingPlan.marketingActivities.createMarketingActivity(marketingActivity) Description: Creates a marketing activity. Required fields: `title`, `description`, `targetDate`, and `marketingActivityType` (must be set and not `UNKNOWN`; one of `SOCIAL_MARKETING`, `EMAIL_MARKETING`, or `BLOG`). Missing any of these returns a `FAILED_PRECONDITION` error. # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: marketingActivity Method parameters: param name: marketingActivity | type: MarketingActivity | description: A single planned marketing action within a site's marketing plan. Activities are generated by the AI when a marketing plan is created and represent concrete tasks such as a social media campaign, a blog post, or an email. Each activity has a title, description, target date, and type. Generating social posts for an activity is handled by the separate Marketing Plan API, not this API. | required: true - name: blogSeoData | type: BlogPostCandidate | description: SEO blog candidate data associated with this activity. Present only when `marketing_activity_type` is `BLOG`. - name: candidateData | type: CandidateData | description: ids of the blog post candidate - name: briefData | type: BriefData | description: data to use to generate blog post seo brief - name: h1Title | type: string | description: title of the blog post | validation: maxLength 1000 - name: keyword | type: string | description: relevant keyword for the blog post | validation: maxLength 1000 - name: mainKeyword | type: string | description: main keyword for the blog post | validation: maxLength 1000 - name: serpData | type: SerpData | description: serp data for the main keyword - name: peopleAlsoAskSuggestions | type: array | description: list of people also ask questions | validation: maxItems 4 - name: question | type: string | description: people also ask question title | validation: maxLength 10000 - name: answers | type: array | description: answers to the question | validation: maxItems 2 - name: title | type: string | description: people also ask answer title | validation: maxLength 10000 - name: description | type: string | description: description of the answer | validation: maxLength 10000 - name: peopleAlsoSearchSuggestions | type: array | description: list of related searches | validation: maxItems 10, maxLength 10000 - name: autocompleteSuggestions | type: array | description: list of autocomplete suggestions | validation: maxItems 15, maxLength 10000 - name: pageUrl | type: string | description: related landing page | validation: maxLength 1000 - name: seoData | type: SeoSchema | description: seo data - name: tags | type: array | description: SEO tag information. - name: type | type: string | description: SEO tag type. Supported values: `title`, `meta`, `script`, `link`. - name: props | type: object | description: A `{"key": "value"}` pair object where each SEO tag property (`"name"`, `"content"`, `"rel"`, `"href"`) contains a value. For example: `{"name": "description", "content": "the description itself"}`. - name: meta | type: object | description: SEO tag metadata. For example, `{"height": 300, "width": 240}`. - name: children | type: string | description: SEO tag inner content. For example, ` inner content `. - name: custom | type: boolean | description: Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages). - name: disabled | type: boolean | description: Whether the tag is disabled. If the tag is disabled, people can't find your page when searching for this phrase in search engines. - name: settings | type: Settings | description: SEO general settings. - name: preventAutoRedirect | type: boolean | description: Whether the [automatical redirect visits](https://support.wix.com/en/article/customizing-your-pages-seo-settings-in-the-seo-panel) from the old URL to the new one is enabled. Default: `false` (automatical redirect is enabled). - name: keywords | type: array | description: User-selected keyword terms for a specific page. | validation: maxItems 5 - name: term | type: string | description: Keyword value. - name: isMain | type: boolean | description: Whether the keyword is the main focus keyword. - name: origin | type: string | description: The source that added the keyword terms to the SEO settings. | validation: maxLength 1000 - name: marketingActivityType | type: ActivityType | description: Category of marketing action this activity represents. - enum: - SOCIAL_MARKETING: Activity targets social media channels (e.g. Facebook, Instagram). - EMAIL_MARKETING: Activity targets an email campaign. - BLOG: Activity targets a blog post. - name: title | type: string | description: Short label for the activity, suitable for display in a marketing plan UI. | validation: maxLength 3000 - name: description | type: string | description: Human-readable explanation of what the activity involves and why it was suggested. | validation: maxLength 3000 - name: targetDate | type: Date | description: Scheduled date by which the activity should be completed or published. - name: source | type: ActivitySource | description: Origin context that the AI used when generating this activity (for example, an upcoming event or a set of keywords). - name: type | type: ActivitySourceType | description: Indicates what kind of input drove the AI to generate this activity. - enum: - EVENT: Activity was generated based on a site event. - KEYWORDS: Activity was generated based on SEO or topic keywords. - CONTENT_PILLARS: Activity was generated based on the site's content pillars. - name: value | type: string | description: The specific value of the source input (for example, an event name or a keyword string). | validation: maxLength 3000 - name: asset | type: AssetReference | description: Site asset this activity is grounded in. - name: type | type: Type | description: Type of the site asset (for example, product or blog post). See `SiteAsset.Type` for the closed set of values. - enum: - BLOG_POST: A Wix Blog post. - EVENT: A Wix Events event. - STORES_PRODUCT: A Wix Stores product. - BOOKINGS_SERVICE: A Wix Bookings service. - STORES_COUPON: A Wix Stores coupon. - STORES_CATEGORY: A Wix Stores category. - name: _id | type: string | description: GUID of the asset within its provider's data store. | validation: maxLength 256 - name: name | type: string | description: Display name of the asset (for example, the product title or blog post title), cached at activity-generation time. | validation: maxLength 3000 Return type: PROMISE - ONE-OF: - name: blogSeoData | type: BlogPostCandidate | description: SEO blog candidate data associated with this activity. Present only when `marketing_activity_type` is `BLOG`. - name: _id | type: string | description: blog post candidate id | validation: format GUID - name: candidateData | type: CandidateData | description: ids of the blog post candidate - name: blogPostCandidateId | type: string | description: id of the blog post topic | validation: format GUID - name: contentPlanFlowId | type: string | description: id of the content plan flow this blog post candidate belongs to | validation: format GUID - name: briefData | type: BriefData | description: data to use to generate blog post seo brief - name: h1Title | type: string | description: title of the blog post | validation: maxLength 1000 - name: keyword | type: string | description: relevant keyword for the blog post | validation: maxLength 1000 - name: mainKeyword | type: string | description: main keyword for the blog post | validation: maxLength 1000 - name: serpData | type: SerpData | description: serp data for the main keyword - name: _id | type: string | description: SerpDataResult GUID | validation: format GUID - name: peopleAlsoAskSuggestions | type: array | description: list of people also ask questions | validation: maxItems 4 - name: question | type: string | description: people also ask question title | validation: maxLength 10000 - name: answers | type: array | description: answers to the question | validation: maxItems 2 - name: title | type: string | description: people also ask answer title | validation: maxLength 10000 - name: description | type: string | description: description of the answer | validation: maxLength 10000 - name: peopleAlsoSearchSuggestions | type: array | description: list of related searches | validation: maxItems 10, maxLength 10000 - name: autocompleteSuggestions | type: array | description: list of autocomplete suggestions | validation: maxItems 15, maxLength 10000 - name: pageUrl | type: string | description: related landing page | validation: maxLength 1000 - name: seoData | type: SeoSchema | description: seo data - name: tags | type: array | description: SEO tag information. - name: type | type: string | description: SEO tag type. Supported values: `title`, `meta`, `script`, `link`. - name: props | type: object | description: A `{"key": "value"}` pair object where each SEO tag property (`"name"`, `"content"`, `"rel"`, `"href"`) contains a value. For example: `{"name": "description", "content": "the description itself"}`. - name: meta | type: object | description: SEO tag metadata. For example, `{"height": 300, "width": 240}`. - name: children | type: string | description: SEO tag inner content. For example, ` inner content `. - name: custom | type: boolean | description: Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages). - name: disabled | type: boolean | description: Whether the tag is disabled. If the tag is disabled, people can't find your page when searching for this phrase in search engines. - name: settings | type: Settings | description: SEO general settings. - name: preventAutoRedirect | type: boolean | description: Whether the [automatical redirect visits](https://support.wix.com/en/article/customizing-your-pages-seo-settings-in-the-seo-panel) from the old URL to the new one is enabled. Default: `false` (automatical redirect is enabled). - name: keywords | type: array | description: User-selected keyword terms for a specific page. | validation: maxItems 5 - name: term | type: string | description: Keyword value. - name: isMain | type: boolean | description: Whether the keyword is the main focus keyword. - name: origin | type: string | description: The source that added the keyword terms to the SEO settings. | validation: maxLength 1000 - name: _id | type: string | description: Unique activity GUID. Assigned on creation and read-only afterwards. | validation: format GUID - name: marketingActivityType | type: ActivityType | description: Category of marketing action this activity represents. - enum: - SOCIAL_MARKETING: Activity targets social media channels (e.g. Facebook, Instagram). - EMAIL_MARKETING: Activity targets an email campaign. - BLOG: Activity targets a blog post. - name: title | type: string | description: Short label for the activity, suitable for display in a marketing plan UI. | validation: maxLength 3000 - name: description | type: string | description: Human-readable explanation of what the activity involves and why it was suggested. | validation: maxLength 3000 - name: targetDate | type: Date | description: Scheduled date by which the activity should be completed or published. - name: source | type: ActivitySource | description: Origin context that the AI used when generating this activity (for example, an upcoming event or a set of keywords). - name: type | type: ActivitySourceType | description: Indicates what kind of input drove the AI to generate this activity. - enum: - EVENT: Activity was generated based on a site event. - KEYWORDS: Activity was generated based on SEO or topic keywords. - CONTENT_PILLARS: Activity was generated based on the site's content pillars. - name: value | type: string | description: The specific value of the source input (for example, an event name or a keyword string). | validation: maxLength 3000 - name: asset | type: AssetReference | description: Site asset this activity is grounded in. - name: type | type: Type | description: Type of the site asset (for example, product or blog post). See `SiteAsset.Type` for the closed set of values. - enum: - BLOG_POST: A Wix Blog post. - EVENT: A Wix Events event. - STORES_PRODUCT: A Wix Stores product. - BOOKINGS_SERVICE: A Wix Bookings service. - STORES_COUPON: A Wix Stores coupon. - STORES_CATEGORY: A Wix Stores category. - name: _id | type: string | description: GUID of the asset within its provider's data store. | validation: maxLength 256 - name: name | type: string | description: Display name of the asset (for example, the product title or blog post title), cached at activity-generation time. | validation: maxLength 3000 ``` ### Examples ### Create a social marketing activity ```javascript import { marketingActivities } from "@wix/promote-growth-tools-marketing-plan"; const marketingActivity = { title: "Summer Sale Instagram Campaign", description: "Promote the summer collection with a series of Instagram posts highlighting new arrivals and seasonal discounts.", targetDate: new Date("2026-07-15T09:00:00.000Z"), marketingActivityType: marketingActivities.ActivityType.SOCIAL_MARKETING, }; async function createMarketingActivity() { const response = await marketingActivities.createMarketingActivity(marketingActivity); } ``` ### createMarketingActivity (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 { marketingActivities } 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: { marketingActivities }, // Include the auth strategy and host as relevant }); async function createMarketingActivity(marketingActivity) { const response = await myWixClient.marketingActivities.createMarketingActivity(marketingActivity); }; ``` ---