Marketing Activity Object


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.

Properties
assetAssetReference

Site asset this activity is grounded in.


blogSeoDataBlogPostCandidate

SEO blog candidate data associated with this activity. Present only when marketing_activity_type is BLOG.


descriptionstringmaxLength 3000

Human-readable explanation of what the activity involves and why it was suggested.


idstringRead-onlyformat GUID

Unique activity ID. Assigned on creation and read-only afterwards.


marketingActivityTypestring

sourceActivitySource

Origin context that the AI used when generating this activity (for example, an upcoming event or a set of keywords).


targetDatestringformat date-time

Scheduled date by which the activity should be completed or published.


titlestringmaxLength 3000

Short label for the activity, suitable for display in a marketing plan UI.

Did this help?