Set customer tier

setCustomerTier(customerId, tierId, triggerRewards, comment, internalComment)

Assigns a customer to a VIP tier. The tier must belong to your shop. By default this only sets the tier. Set triggerRewards to true to also issue the rewards attached to the tier, the same as ticking “give this tier’s rewards” on the admin tier change.

Arguments

Name	Type	Required	Description
customerId	ID!	Yes	The Shopify customer ID.
tierId	ID!	Yes	The tier to assign.
triggerRewards	Boolean	No	When true, also issue the tier’s rewards to the customer. Defaults to false.
comment	String	No	Customer-facing note recorded against the change.
internalComment	String	No	Staff-only note recorded against the change.

Returns a non-null Customer reflecting the new tier.

Returns / Fields

Returns the updated Customer. See the type reference for the full field list.

Example

mutation {
  setCustomerTier(customerId: "6677889900", tierId: "3") {
    id
    vipTierId
    vipTierName
  }
}

{
  "data": {
    "setCustomerTier": {
      "id": "6677889900",
      "vipTierId": 3,
      "vipTierName": "Gold"
    }
  }
}

Returns an error with message TIER_NOT_FOUND if the tier does not belong to your shop, CUSTOMER_NOT_FOUND for an unknown customer, or TIER_UPDATE_FAILED if the change could not be applied.