---
title: >-
  Introducing the URLParameterValue field on all marketing activities and
  aligned types on userErrors in the Marketing Activity API - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/introducing-the-urlparametervalue-field-on-all-marketing-activities-and-aligned-types-on-usererrors-in-the-marketing-activity-api
  md: >-
    https://shopify.dev/changelog/introducing-the-urlparametervalue-field-on-all-marketing-activities-and-aligned-types-on-usererrors-in-the-marketing-activity-api.md
metadata:
  effectiveApiVersion: 2024-07
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: true
  createdAt: '2024-06-03T17:00:09-04:00'
  postedAt: '2024-06-04T16:40:00-04:00'
  updatedAt: '2024-06-04T12:25:10-04:00'
  effectiveAt: '2024-06-04T16:40:00-04:00'
---

June 4, 2024

Tags:

* Action Required
* Admin GraphQL API
* 2024-07

# Introducing the URLParameterValue field on all marketing activities and aligned types on userErrors in the Marketing Activity API

As of API version `2024-07`, you can use the `url_parameter_value` as a tracking parameter in the `MarketingActivityCreate` and `MarketingActivityUpdate` mutations. This feature is currently available on a limited basis to some partners only. UTMs should continue to be used for most partners' tracking parameters.

Additionally, `MarketingActivityUserError` will be the required type on the `user_errors` field for the `MarketingEngagementCreate` mutation. This will match the `user_error` types of the other mutations that belong to the Marketing Activity and Engagements API.