# MarketingActivity - admin-graphql - OBJECT Version: 2024-10 ## 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-graphql/2024-10/scalars/URL): URL - The URL of the marketing activity listing page in the marketing section. * [adSpend](/docs/api/admin-graphql/2024-10/objects/MoneyV2): MoneyV2 - The amount spent on the marketing activity. * [app](/docs/api/admin-graphql/2024-10/objects/App): App! - The app which created this marketing activity. * [appErrors](/docs/api/admin-graphql/2024-10/objects/MarketingActivityExtensionAppErrors): MarketingActivityExtensionAppErrors - The errors generated when an app publishes the marketing activity. * [budget](/docs/api/admin-graphql/2024-10/objects/MarketingBudget): MarketingBudget - The allocated budget for the marketing activity. * [createdAt](/docs/api/admin-graphql/2024-10/scalars/DateTime): DateTime! - The date and time when the marketing activity was created. * [formData](/docs/api/admin-graphql/2024-10/scalars/String): String - The completed content in the marketing activity creation form. * [hierarchyLevel](/docs/api/admin-graphql/2024-10/enums/MarketingActivityHierarchyLevel): MarketingActivityHierarchyLevel - The hierarchy level of the marketing activity. * [id](/docs/api/admin-graphql/2024-10/scalars/ID): ID! - A globally-unique ID. * [inMainWorkflowVersion](/docs/api/admin-graphql/2024-10/scalars/Boolean): Boolean! - Whether the marketing activity is in the main workflow version of the marketing automation. * [isExternal](/docs/api/admin-graphql/2024-10/scalars/Boolean): Boolean! - The marketing activity represents an external marketing activity. * [marketingChannel](/docs/api/admin-graphql/2024-10/enums/MarketingChannel): MarketingChannel! - The medium through which the marketing activity and event reached consumers. This is used for reporting aggregation. * [marketingChannelType](/docs/api/admin-graphql/2024-10/enums/MarketingChannel): MarketingChannel! - The medium through which the marketing activity and event reached consumers. This is used for reporting aggregation. * [marketingEvent](/docs/api/admin-graphql/2024-10/objects/MarketingEvent): MarketingEvent - Associated marketing event of this marketing activity. * [parentActivityId](/docs/api/admin-graphql/2024-10/scalars/ID): ID - ID of the parent activity of this marketing activity. * [parentRemoteId](/docs/api/admin-graphql/2024-10/scalars/String): String - ID of the parent activity of this marketing activity. * [sourceAndMedium](/docs/api/admin-graphql/2024-10/scalars/String): String! - A contextual description of the marketing activity based on the platform and tactic used. * [status](/docs/api/admin-graphql/2024-10/enums/MarketingActivityStatus): MarketingActivityStatus! - The current state of the marketing activity. * [statusBadgeType](/docs/api/admin-graphql/2024-10/enums/MarketingActivityStatusBadgeType): MarketingActivityStatusBadgeType - The severity of the marketing activity's status. * [statusBadgeTypeV2](/docs/api/admin-graphql/2024-10/enums/BadgeType): BadgeType - The severity of the marketing activity's status. * [statusLabel](/docs/api/admin-graphql/2024-10/scalars/String): String! - The rendered status of the marketing activity. * [statusTransitionedAt](/docs/api/admin-graphql/2024-10/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-graphql/2024-10/enums/MarketingTactic): MarketingTactic! - The method of marketing used for this marketing activity. * [targetStatus](/docs/api/admin-graphql/2024-10/enums/MarketingActivityStatus): MarketingActivityStatus - The status to which the marketing activity is currently transitioning. * [title](/docs/api/admin-graphql/2024-10/scalars/String): String! - The marketing activity's title, which is rendered on the marketing listing page. * [updatedAt](/docs/api/admin-graphql/2024-10/scalars/DateTime): DateTime! - The date and time when the marketing activity was updated. * [urlParameterValue](/docs/api/admin-graphql/2024-10/scalars/String): String - The value portion of the URL query parameter used in attributing sessions to this activity. * [utmParameters](/docs/api/admin-graphql/2024-10/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-graphql/2024-10/queries/marketingActivity) Returns a MarketingActivity resource by ID. * [marketingActivities](/docs/api/admin-graphql/2024-10/queries/marketingActivities) A list of marketing activities associated with the marketing app. ## Related mutations * [marketingActivityCreateExternal](/docs/api/admin-graphql/2024-10/mutations/marketingActivityCreateExternal) Creates a new external marketing activity. * [marketingActivityCreate](/docs/api/admin-graphql/2024-10/mutations/marketingActivityCreate) Create new marketing activity. * [marketingActivityUpdateExternal](/docs/api/admin-graphql/2024-10/mutations/marketingActivityUpdateExternal) Update an external marketing activity. * [marketingActivityUpdate](/docs/api/admin-graphql/2024-10/mutations/marketingActivityUpdate) Updates a marketing activity with the latest information. * [marketingActivityUpsertExternal](/docs/api/admin-graphql/2024-10/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