Skip to main content
object

Requires read_marketing_events access scope.

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

•URL

The URL of the marketing activity listing page in the marketing section.

•MoneyV2

The amount spent on the marketing activity.

•App!non-null

The app which created this marketing activity.

•MarketingActivityExtensionAppErrors

The errors generated when an app publishes the marketing activity.

•MarketingBudget

The allocated budget for the marketing activity.

•DateTime!non-null

The date and time when the marketing activity was created.

•String

The completed content in the marketing activity creation form.

•MarketingActivityHierarchyLevel

The hierarchy level of the marketing activity.

•ID!non-null

A globally-unique ID.

Anchor to inMainWorkflowVersioninMainWorkflowVersion
•Boolean!non-null

Whether the marketing activity is in the main workflow version of the marketing automation.

•Boolean!non-null

The marketing activity represents an external marketing activity.

Anchor to marketingChannelTypemarketingChannelType
•MarketingChannel!non-null

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

•MarketingEvent

Associated marketing event of this marketing activity.

•ID

ID of the parent activity of this marketing activity.

•String

ID of the parent activity of this marketing activity.

•String!non-null

A contextual description of the marketing activity based on the platform and tactic used.

•MarketingActivityStatus!non-null

The current state of the marketing activity.

•BadgeType

The severity of the marketing activity's status.

•String!non-null

The rendered status of the marketing activity.

Anchor to statusTransitionedAtstatusTransitionedAt
•DateTime

The date and time when the activity's status last changed.

•MarketingTactic!non-null

The method of marketing used for this marketing activity.

•MarketingActivityStatus

The status to which the marketing activity is currently transitioning.

•String!non-null

The marketing activity's title, which is rendered on the marketing listing page.

•DateTime!non-null

The date and time when the marketing activity was updated.

•String

The value portion of the URL query parameter used in attributing sessions to this activity.

•UTMParameters

The set of Urchin Tracking Module used in the URL for tracking this marketing activity.

Deprecated fields

•MarketingChannel!non-nullDeprecated

Was this section helpful?

•query

A list of marketing activities associated with the marketing app.

•query

Returns a MarketingActivity resource by ID.


Was this section helpful?

•mutation

Create new marketing activity.

Arguments

•MarketingActivityCreateInput!required

The Input of marketing activity create.


Fields

•MarketingActivity

The created marketing activity.

•String

The path to return back to shopify admin from embedded editor.

•[UserError!]!non-null

The list of errors that occurred from executing the mutation.

•mutation

Creates a new external marketing activity.

Arguments

•MarketingActivityCreateExternalInput!required

The input field for creating an external marketing activity.


Fields

•MarketingActivity

The external marketing activity that was created.

•[MarketingActivityUserError!]!non-null

The list of errors that occurred from executing the mutation.

•mutation

Updates a marketing activity with the latest information.

Arguments

•MarketingActivityUpdateInput!required

The Input of the marketing activity.


Fields

•MarketingActivity

The updated marketing activity.

•String

The redirect path from the embedded editor to the Shopify admin.

•[UserError!]!non-null

The list of errors that occurred from executing the mutation.

•mutation

Update an external marketing activity.

Arguments

•MarketingActivityUpdateExternalInput!required

The input field for updating an external marketing activity.

•ID

The ID of the marketing activity. Specify either the marketing activity ID, remote ID, or UTM to update the marketing activity.

•String

A custom unique identifier for the marketing activity, which can be used to manage the activity and send engagement metrics without having to store our marketing activity ID in your systems. Specify either the marketing activity ID, remote ID, or UTM to update the marketing activity.

•UTMInput

Specifies the Urchin Traffic Module (UTM) parameters that are associated with a related marketing campaign. Specify either the marketing activity ID, remote ID, or UTM to update the marketing activity.


Fields

•MarketingActivity

The updated marketing activity.

•[MarketingActivityUserError!]!non-null

The list of errors that occurred from executing the mutation.

•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.

Arguments

•MarketingActivityUpsertExternalInput!required

The input field for creating or updating an external marketing activity.


Fields

•MarketingActivity

The external marketing activity that was created or updated.

•[MarketingActivityUserError!]!non-null

The list of errors that occurred from executing the mutation.


Was this section helpful?

•interface

Was this section helpful?