# MarketingActivity - admin - OBJECT
Version: 2025-01

## Description
The marketing activity resource represents marketing that a
        merchant created through an app.

### Access Scopes
`read_marketing_events` access scope.


## Fields
* [activityListUrl](/docs/api/admin/2025-01/scalars/URL): URL - The URL of the marketing activity listing page in the marketing section.
* [adSpend](/docs/api/admin/2025-01/objects/MoneyV2): MoneyV2 - The amount spent on the marketing activity.
* [app](/docs/api/admin/2025-01/objects/App): App! - The app which created this marketing activity.
* [appErrors](/docs/api/admin/2025-01/objects/MarketingActivityExtensionAppErrors): MarketingActivityExtensionAppErrors - The errors generated when an app publishes the marketing activity.
* [budget](/docs/api/admin/2025-01/objects/MarketingBudget): MarketingBudget - The allocated budget for the marketing activity.
* [createdAt](/docs/api/admin/2025-01/scalars/DateTime): DateTime! - The date and time when the marketing activity was created.
* [formData](/docs/api/admin/2025-01/scalars/String): String - The completed content in the marketing activity creation form.
* [hierarchyLevel](/docs/api/admin/2025-01/enums/MarketingActivityHierarchyLevel): MarketingActivityHierarchyLevel - The hierarchy level of the marketing activity.
* [id](/docs/api/admin/2025-01/scalars/ID): ID! - A globally-unique ID.
* [inMainWorkflowVersion](/docs/api/admin/2025-01/scalars/Boolean): Boolean! - Whether the marketing activity is in the main workflow version of the marketing automation.
* [isExternal](/docs/api/admin/2025-01/scalars/Boolean): Boolean! - The marketing activity represents an external marketing activity.
* [marketingChannel](/docs/api/admin/2025-01/enums/MarketingChannel): MarketingChannel! - The medium through which the marketing activity and event reached consumers. This is used for reporting aggregation.
* [marketingChannelType](/docs/api/admin/2025-01/enums/MarketingChannel): MarketingChannel! - The medium through which the marketing activity and event reached consumers. This is used for reporting aggregation.
* [marketingEvent](/docs/api/admin/2025-01/objects/MarketingEvent): MarketingEvent - Associated marketing event of this marketing activity.
* [parentActivityId](/docs/api/admin/2025-01/scalars/ID): ID - ID of the parent activity of this marketing activity.
* [parentRemoteId](/docs/api/admin/2025-01/scalars/String): String - ID of the parent activity of this marketing activity.
* [sourceAndMedium](/docs/api/admin/2025-01/scalars/String): String! - A contextual description of the marketing activity based on the platform and tactic used.
* [status](/docs/api/admin/2025-01/enums/MarketingActivityStatus): MarketingActivityStatus! - The current state of the marketing activity.
* [statusBadgeType](/docs/api/admin/2025-01/enums/MarketingActivityStatusBadgeType): MarketingActivityStatusBadgeType - The severity of the marketing activity's status.
* [statusBadgeTypeV2](/docs/api/admin/2025-01/enums/BadgeType): BadgeType - The severity of the marketing activity's status.
* [statusLabel](/docs/api/admin/2025-01/scalars/String): String! - The rendered status of the marketing activity.
* [statusTransitionedAt](/docs/api/admin/2025-01/scalars/DateTime): DateTime - The [date and time](
          https://help.shopify.com/https://en.wikipedia.org/wiki/ISO_8601
          ) when the activity's status last changed.
* [tactic](/docs/api/admin/2025-01/enums/MarketingTactic): MarketingTactic! - The method of marketing used for this marketing activity.
* [targetStatus](/docs/api/admin/2025-01/enums/MarketingActivityStatus): MarketingActivityStatus - The status to which the marketing activity is currently transitioning.
* [title](/docs/api/admin/2025-01/scalars/String): String! - The marketing activity's title, which is rendered on the marketing listing page.
* [updatedAt](/docs/api/admin/2025-01/scalars/DateTime): DateTime! - The date and time when the marketing activity was updated.
* [urlParameterValue](/docs/api/admin/2025-01/scalars/String): String - The value portion of the URL query parameter used in attributing sessions to this activity.
* [utmParameters](/docs/api/admin/2025-01/objects/UTMParameters): UTMParameters - The set of [Urchin Tracking Module](
          https://help.shopify.com/https://en.wikipedia.org/wiki/UTM_parameters
          ) used in the URL for tracking this marketing activity.

## Connections



## Related queries
* [marketingActivity](/docs/api/admin/2025-01/queries/marketingActivity) Returns a MarketingActivity resource by ID.
* [marketingActivities](/docs/api/admin/2025-01/queries/marketingActivities) A list of marketing activities associated with the marketing app.

## Related mutations
* [marketingActivityCreateExternal](/docs/api/admin/2025-01/mutations/marketingActivityCreateExternal) Creates a new external marketing activity.
* [marketingActivityCreate](/docs/api/admin/2025-01/mutations/marketingActivityCreate) Create new marketing activity.
* [marketingActivityUpdateExternal](/docs/api/admin/2025-01/mutations/marketingActivityUpdateExternal) Update an external marketing activity.
* [marketingActivityUpdate](/docs/api/admin/2025-01/mutations/marketingActivityUpdate) Updates a marketing activity with the latest information.
* [marketingActivityUpsertExternal](/docs/api/admin/2025-01/mutations/marketingActivityUpsertExternal) Creates a new external marketing activity or updates an existing one. When optional fields are absent or null, associated information will be removed from an existing marketing activity.

## Related Unions

## Examples