---
title: MarketingEvent - GraphQL Admin
description: Represents actions that market a merchant's store or products.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/marketingevent
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/marketingevent.md
---

# Marketing​Event

object

Requires `read_marketing_events` access scope.

Represents actions that market a merchant's store or products.

## Fields

* app

  [App!](https://shopify.dev/docs/api/admin-graphql/latest/objects/App)

  non-null

  The app that the marketing event is attributed to.

* channel​Handle

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The unique string identifier of the channel to which this activity belongs. For the correct handle for your channel, contact your partner manager.

* description

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  A human-readable description of the marketing event.

* ended​At

  [Date​Time](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  The date and time when the marketing event ended.

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  A globally-unique ID.

* legacy​Resource​Id

  [Unsigned​Int64!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/UnsignedInt64)

  non-null

  The ID of the corresponding resource in the REST Admin API.

* manage​Url

  [URL](https://shopify.dev/docs/api/admin-graphql/latest/scalars/URL)

  The URL where the marketing event can be managed.

* marketing​Channel​Type

  [Marketing​Channel](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketingChannel)

  The medium through which the marketing activity and event reached consumers. This is used for reporting aggregation.

* preview​Url

  [URL](https://shopify.dev/docs/api/admin-graphql/latest/scalars/URL)

  The URL where the marketing event can be previewed.

* remote​Id

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  An optional ID that helps Shopify validate engagement data.

* scheduled​To​End​At

  [Date​Time](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  The date and time when the marketing event is scheduled to end.

* source​And​Medium

  [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  Where the `MarketingEvent` occurred and what kind of content was used. Because `utmSource` and `utmMedium` are often used interchangeably, this is based on a combination of `marketingChannel`, `referringDomain`, and `type` to provide a consistent representation for any given piece of marketing regardless of the app that created it.

* started​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  non-null

  The date and time when the marketing event started.

* type

  [Marketing​Tactic!](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketingTactic)

  non-null

  The marketing event type.

* utm​Campaign

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The name of the marketing campaign.

* utm​Medium

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The medium that the marketing campaign is using. Example values: `cpc`, `banner`.

* utm​Source

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The referrer of the marketing event. Example values: `google`, `newsletter`.

### Deprecated fields

* channel

  [Marketing​Channel](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketingChannel)

  Deprecated

* target​Type​Display​Text

  [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-nullDeprecated

***

## Map

### Fields and connections with this object

* {}[CustomerVisit.marketingEvent](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerVisit#field-CustomerVisit.fields.marketingEvent)
* {}[MarketingActivity.marketingEvent](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketingActivity#field-MarketingActivity.fields.marketingEvent)
* <->[MarketingEventConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/MarketingEventConnection#returns-nodes)
* {}[MarketingEventEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketingEventEdge#field-MarketingEventEdge.fields.node)

***

## Queries

* [marketing​Event](https://shopify.dev/docs/api/admin-graphql/latest/queries/marketingEvent)

  query

  Returns a `MarketingEvent` resource by ID.

* [marketing​Events](https://shopify.dev/docs/api/admin-graphql/latest/queries/marketingEvents)

  query

  A list of marketing events associated with the marketing app.

***

## \<?>MarketingEvent Queries

### Queried by

* \<?>[marketing​Event](https://shopify.dev/docs/api/admin-graphql/latest/queries/marketingEvent)
* \<?>[marketing​Events](https://shopify.dev/docs/api/admin-graphql/latest/queries/marketingEvents)

***

## Interfaces

* * [Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/LegacyInteroperability)

    interface

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

    interface

***

## ||-MarketingEvent Implements

### Implements

* ||-[Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/LegacyInteroperability)
* ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)