---
title: MarketingActivity - GraphQL Admin
description: |-
  The marketing activity resource represents marketing that a
          merchant created through an app.
api_version: 2026-01
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

* activityListUrl
* adSpend
* app
* appErrors
* budget
* createdAt
* formData
* hierarchyLevel
* id
* inMainWorkflowVersion
* isExternal
* marketingChannelType
* marketingEvent
* parentActivityId
* parentRemoteId
* sourceAndMedium
* status
* statusBadgeTypeV2
* statusLabel
* statusTransitionedAt
* tactic
* targetStatus
* title
* updatedAt
* urlParameterValue
* utmParameters

### Deprecated fields

* marketingChannel: deprecated
* statusBadgeType: 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

* marketingActivities
* marketingActivity

***

## 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

* marketingActivityCreate
* marketingActivityCreateExternal
* marketingActivityUpdate
* marketingActivityUpdateExternal
* marketingActivityUpsertExternal

***

## 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

***

## MarketingActivity Implements

### Implements

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)