# MarketingActivityCreateExternalInput - admin-graphql - INPUT_OBJECT
Version: 2024-10

## Description
The input fields for creating an externally-managed marketing activity.

### Access Scopes



## Fields
* [adSpend](/docs/api/admin-graphql/2024-10/input-objects/MoneyInput): MoneyInput - The amount spent on the marketing activity.
* [budget](/docs/api/admin-graphql/2024-10/input-objects/MarketingActivityBudgetInput): MarketingActivityBudgetInput - The budget for this marketing activity.
* [channel](/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.
* [channelHandle](/docs/api/admin-graphql/2024-10/scalars/String): String - The unique string identifier of the channel to which this activity belongs. For the correct handle for your channel, contact your partner manager.
* [end](/docs/api/admin-graphql/2024-10/scalars/DateTime): DateTime - The date and time at which the activity ended. If omitted or set to `null`, the current time will be used if the status is set to `INACTIVE` or `DELETED_EXTERNALLY`.
* [hierarchyLevel](/docs/api/admin-graphql/2024-10/enums/MarketingActivityHierarchyLevel): MarketingActivityHierarchyLevel - The hierarchy level of the activity within a campaign. The hierarchy level can't be updated.
* [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.
* [parentActivityId](/docs/api/admin-graphql/2024-10/scalars/ID): ID - The ID for the parent marketing activity, if creating hierarchical activities.
* [parentRemoteId](/docs/api/admin-graphql/2024-10/scalars/String): String - The remote ID for the parent marketing activity, if creating hierarchical activities.
* [referringDomain](/docs/api/admin-graphql/2024-10/scalars/String): String - The domain from which ad clicks are forwarded to the shop.
* [remoteId](/docs/api/admin-graphql/2024-10/scalars/String): String - The ID of an activity that's hosted outside of Shopify.
* [remotePreviewImageUrl](/docs/api/admin-graphql/2024-10/scalars/URL): URL - The URL for a preview image that's used for the marketing activity.
* [remoteUrl](/docs/api/admin-graphql/2024-10/scalars/URL): URL! - The URL for viewing and/or managing the activity outside of Shopify.
* [scheduledEnd](/docs/api/admin-graphql/2024-10/scalars/DateTime): DateTime - The date and time at which the activity is scheduled to end.
* [scheduledStart](/docs/api/admin-graphql/2024-10/scalars/DateTime): DateTime - The date and time at which the activity is scheduled to start.
* [start](/docs/api/admin-graphql/2024-10/scalars/DateTime): DateTime - The date and time at which the activity started. If omitted or set to `null`, the current time will be used.
* [status](/docs/api/admin-graphql/2024-10/enums/MarketingActivityExternalStatus): MarketingActivityExternalStatus - The status of the marketing activity. If status isn't set it will default to UNDEFINED.
* [tactic](/docs/api/admin-graphql/2024-10/enums/MarketingTactic): MarketingTactic! - The method of marketing used for this marketing activity. The marketing tactic determines which default fields are included in the marketing activity.
* [title](/docs/api/admin-graphql/2024-10/scalars/String): String! - The title of the marketing activity.
* [urlParameterValue](/docs/api/admin-graphql/2024-10/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.
* [utm](/docs/api/admin-graphql/2024-10/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. Either the URL parameter value or UTM can be set, but not both.


## Input objects with this input object
* [marketingActivityCreateExternal](/docs/api/admin-graphql/2024-10/mutations/marketingActivityCreateExternal)


## Examples