---
title: ShippingLabelPurchaseInput - GraphQL Admin
description: |-
  The input fields for the fulfillment order, shipping date and time, package
  details, weight, notification setting, and optional rate preference used to
  purchase a shipping label.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShippingLabelPurchaseInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShippingLabelPurchaseInput.md
api_name: admin
api_type: graphql
type: input-object
---

# Shipping​Label​Purchase​Input

input\_object

The input fields for the fulfillment order, shipping date and time, package details, weight, notification setting, and optional rate preference used to purchase a shipping label.

## Fields

* fulfillment​Order​Id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  The ID of the fulfillment order to create the shipping label for. The fulfillment order must be fulfillable, require shipping, and have a destination shipping address.

* notify​Customer

  [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  Default:false

  Whether to notify the customer after the shipping label is purchased.

* origin​Address

  [Mailing​Address​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/MailingAddressInput)

  A custom ship-from origin address that overrides the fulfillment order's assigned location for this label. If not provided, the assigned location is used.

* package​Info

  [Package​Info​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/PackageInfoInput)

  The package to use for the shipment. Provide either a custom package or a carrier-provided package.

* preferred​Rate​Selection

  [Preferred​Rate​Selection​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/PreferredRateSelectionInput)

  The preferred carrier and service to use for the shipping label. If omitted, the mutation uses Shopify Shipping's default rate selection.

* shipping​Datetime

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  non-null

  The date and time when the package is expected to be shipped. The value must not be in the past.

* total​Weight

  [Weight​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/WeightInput)

  Total shipment weight, including the items being fulfilled and the package. If omitted, the total weight used is calculated using the weight of the empty package and the weight of the fulfillable line items.

***

## Mutations using this input

* [shipping​Label​Purchase.shippingLabelPurchase](https://shopify.dev/docs/api/admin-graphql/latest/mutations/shippingLabelPurchase#arguments-shippingLabelPurchase)

  ARGUMENT

***

## Map

### Mutations using this input

* [shipping​Label​Purchase.shippingLabelPurchase](https://shopify.dev/docs/api/admin-graphql/latest/mutations/shippingLabelPurchase#arguments-shippingLabelPurchase)