--- title: MarketingActivity - GraphQL Admin description: |- The marketing activity resource represents marketing that a merchant created through an app. api_version: 2025-10 api_name: admin type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketingActivity md: https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketingActivity.md --- # Marketing​Activity object Requires `read_marketing_events` access scope. The marketing activity resource represents marketing that a merchant created through an app. ## Fields * activity​List​Url [URL](https://shopify.dev/docs/api/admin-graphql/latest/scalars/URL) The URL of the marketing activity listing page in the marketing section. * ad​Spend [Money​V2](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyV2) The amount spent on the marketing activity. * app [App!](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) non-null The app which created this marketing activity. * app​Errors [Marketing​Activity​Extension​App​Errors](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketingActivityExtensionAppErrors) The errors generated when an app publishes the marketing activity. * budget [Marketing​Budget](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketingBudget) The allocated budget for the marketing activity. * created​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) non-null The date and time when the marketing activity was created. * form​Data [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The completed content in the marketing activity creation form. * hierarchy​Level [Marketing​Activity​Hierarchy​Level](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketingActivityHierarchyLevel) The hierarchy level of the marketing activity. * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) non-null A globally-unique ID. * in​Main​Workflow​Version [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether the marketing activity is in the main workflow version of the marketing automation. * is​External [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null The marketing activity represents an external marketing activity. * marketing​Channel​Type [Marketing​Channel!](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketingChannel) non-null The medium through which the marketing activity and event reached consumers. This is used for reporting aggregation. * marketing​Event [Marketing​Event](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketingEvent) Associated marketing event of this marketing activity. * parent​Activity​Id [ID](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) ID of the parent activity of this marketing activity. * parent​Remote​Id [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) ID of the parent activity of this marketing activity. * source​And​Medium [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null A contextual description of the marketing activity based on the platform and tactic used. * status [Marketing​Activity​Status!](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketingActivityStatus) non-null The current state of the marketing activity. * status​Badge​Type​V2 [Badge​Type](https://shopify.dev/docs/api/admin-graphql/latest/enums/BadgeType) The severity of the marketing activity's status. * status​Label [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The rendered status of the marketing activity. * status​Transitioned​At [Date​Time](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) The [date and time](https://help.shopify.com/https://en.wikipedia.org/wiki/ISO_8601) when the activity's status last changed. * tactic [Marketing​Tactic!](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketingTactic) non-null The method of marketing used for this marketing activity. * target​Status [Marketing​Activity​Status](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketingActivityStatus) The status to which the marketing activity is currently transitioning. * title [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The marketing activity's title, which is rendered on the marketing listing page. * updated​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) non-null The date and time when the marketing activity was updated. * url​Parameter​Value [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The value portion of the URL query parameter used in attributing sessions to this activity. * utm​Parameters [UTMParameters](https://shopify.dev/docs/api/admin-graphql/latest/objects/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. ### Deprecated fields * marketing​Channel [Marketing​Channel!](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketingChannel) non-nullDeprecated * status​Badge​Type [Marketing​Activity​Status​Badge​Type](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketingActivityStatusBadgeType) Deprecated *** ## Map ### Fields and connections with this object * <->[MarketingActivityConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/MarketingActivityConnection#returns-nodes) * {}[MarketingActivityEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketingActivityEdge#field-MarketingActivityEdge.fields.node) * {}[MarketingEngagement.marketingActivity](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketingEngagement#field-MarketingEngagement.fields.marketingActivity) *** ## Queries * [marketing​Activities](https://shopify.dev/docs/api/admin-graphql/latest/queries/marketingActivities) query A list of marketing activities associated with the marketing app. * [marketing​Activity](https://shopify.dev/docs/api/admin-graphql/latest/queries/marketingActivity) query Returns a `MarketingActivity` resource by ID. *** ## \MarketingActivity Queries ### Queried by * \[marketing​Activities](https://shopify.dev/docs/api/admin-graphql/latest/queries/marketingActivities) * \[marketing​Activity](https://shopify.dev/docs/api/admin-graphql/latest/queries/marketingActivity) *** ## Mutations * [marketing​Activity​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketingActivityCreate) mutation Create new marketing activity. Marketing activity app extensions are deprecated and will be removed in the near future. * [marketing​Activity​Create​External](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketingActivityCreateExternal) mutation Creates a new external marketing activity. * [marketing​Activity​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketingActivityUpdate) mutation Updates a marketing activity with the latest information. Marketing activity app extensions are deprecated and will be removed in the near future. * [marketing​Activity​Update​External](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketingActivityUpdateExternal) mutation Update an external marketing activity. * [marketing​Activity​Upsert​External](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketingActivityUpsertExternal) mutation 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. *** ## <\~> MarketingActivity Mutations ### Mutated by * <\~>[marketing​Activity​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketingActivityCreate) * <\~>[marketing​Activity​Create​External](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketingActivityCreateExternal) * <\~>[marketing​Activity​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketingActivityUpdate) * <\~>[marketing​Activity​Update​External](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketingActivityUpdateExternal) * <\~>[marketing​Activity​Upsert​External](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketingActivityUpsertExternal) *** ## Interfaces * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node) interface *** ## ||-MarketingActivity Implements ### Implements * ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)