# MarketingActivityUpdateInput - admin-graphql - INPUT_OBJECT Version: unstable ## Description The input fields required to update a marketing activity. ### Access Scopes ## Fields * [adSpend](/docs/api/admin-graphql/unstable/input-objects/MoneyInput): MoneyInput - The cumulative amount spent on the marketing activity. * [budget](/docs/api/admin-graphql/unstable/input-objects/MarketingActivityBudgetInput): MarketingActivityBudgetInput - The budget for the marketing activity. * [context](/docs/api/admin-graphql/unstable/scalars/String): String - Encoded context provided by Shopify during the update marketing activity callback. * [errorOccurredAt](/docs/api/admin-graphql/unstable/scalars/DateTime): DateTime - The time at which the most recent error occurred. * [errors](/docs/api/admin-graphql/unstable/scalars/JSON): JSON - The error messages that were generated when the app was trying to complete the activity. Learn more about the [JSON format expected for error messages](/api/marketing-activities/statuses#failed-status). * [eventContext](/docs/api/admin-graphql/unstable/scalars/String): String - The event context of the marketing activity. The event context is relayed from the external editor URL. * [formData](/docs/api/admin-graphql/unstable/scalars/String): String - The form data of the marketing activity. This is only used if the marketing activity is integrated with the external editor. * [id](/docs/api/admin-graphql/unstable/scalars/ID): ID! - The ID of the marketing activity. * [marketedResources](/docs/api/admin-graphql/unstable/scalars/ID): ID - A list of the item IDs that were marketed in this marketing activity. Valid types for these items are: * `Product` * `Shop` * [marketingRecommendationId](/docs/api/admin-graphql/unstable/scalars/ID): ID - The ID of the recommendation that the marketing activity was created from, if one exists. * [scheduledToEndAt](/docs/api/admin-graphql/unstable/scalars/DateTime): DateTime - The time at which the activity is scheduled to end. * [scheduledToStartAt](/docs/api/admin-graphql/unstable/scalars/DateTime): DateTime - The time at which the activity is scheduled to start. * [status](/docs/api/admin-graphql/unstable/enums/MarketingActivityStatus): MarketingActivityStatus - The current state of the marketing activity. Learn more about [marketing activities statuses](/api/marketing-activities/statuses). * [targetStatus](/docs/api/admin-graphql/unstable/enums/MarketingActivityStatus): MarketingActivityStatus - The target state that the marketing activity is transitioning to. Learn more about [marketing activities statuses](/api/marketing-activities/statuses). * [title](/docs/api/admin-graphql/unstable/scalars/String): String - The title of the marketing activity. * [trackingOpens](/docs/api/admin-graphql/unstable/scalars/Boolean): Boolean - Whether the marketing activity is tracking the email open rate. * [urlParameterValue](/docs/api/admin-graphql/unstable/scalars/String): String - Value for a query parameter that gets inserted into storefront URLs for matching storefront traffic to this activity. This feature is currently available on a limited basis to some partners only. UTMs should continue to be used for most partners. Both the URL parameter value and UTM parameters can be set. * [useExternalEditor](/docs/api/admin-graphql/unstable/scalars/Boolean): Boolean - Whether the marketing activity uses the external editor. * [utm](/docs/api/admin-graphql/unstable/input-objects/UTMInput): UTMInput - Specifies the [Urchin Traffic Module (UTM) parameters](https://en.wikipedia.org/wiki/UTM_parameters) that are associated with a related marketing campaign. UTMInput is required for all Marketing tactics except Storefront App. The utm field can only be set once and never modified. ## Input objects with this input object * [marketingActivityUpdate](/docs/api/admin-graphql/unstable/mutations/marketingActivityUpdate) ## Examples