---
title: OrderAttributionDefinitionUpsertPayload - GraphQL Admin
description: Return type for `orderAttributionDefinitionUpsert` mutation.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/OrderAttributionDefinitionUpsertPayload
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/OrderAttributionDefinitionUpsertPayload.md
api_name: admin
api_type: graphql
type: payload
---

# Order​Attribution​Definition​Upsert​Payload

payload

Return type for `orderAttributionDefinitionUpsert` mutation.

## Fields

* order​Attribution​Definition

  [Order​Attribution​Definition](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderAttributionDefinition)

  The order attribution definition that was upserted.

* user​Errors

  [\[Order​Attribution​Definition​Upsert​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderAttributionDefinitionUpsertUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [order​Attribution​Definition​Upsert](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderAttributionDefinitionUpsert)

  mutation

  Upserts an order attribution definition for the calling app on the current shop. Apps can use attribution definitions to label orders they route to a shop, replacing or augmenting any definitions shipped declaratively via the `order_attribution_config` extension.

  Learn more in the [order attribution guide](https://shopify.dev/docs/apps/build/sales-channels/order-attribution).

  If a definition with the same handle exists for this app on the shop, the supplied input fields are merged onto it; fields omitted from the input are left unchanged. Otherwise a new definition is created. To explicitly clear the stored `icon` on an existing definition, pass `icon: null`.

  * input

    [Order​Attribution​Definition​Upsert​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/OrderAttributionDefinitionUpsertInput)

    required

    ### Arguments

    The input fields for upserting the order attribution definition.

  ***

***

## Map

### Mutations with this payload

* [order​Attribution​Definition​Upsert](https://shopify.dev/docs/api/admin-graphql/latest/mutations/orderAttributionDefinitionUpsert)