fulfillmentServiceCreate

mutation

Requires write_fulfillments access scope. Also: The user must have fulfill_and_ship_orders permission.

Creates a fulfillment service.

Fulfillment service location

When creating a fulfillment service, a new location will be automatically created on the shop and will be associated with this fulfillment service. This location will be named after the fulfillment service and inherit the shop's address.

If you are using API version 2023-10 or later, and you need to specify custom attributes for the fulfillment service location (for example, to change its address to a country different from the shop's country), use the LocationEdit mutation after creating the fulfillment service.

Arguments

Anchor to callbackUrlcallbackUrl • URL!required: The URL to send requests for the fulfillment service. The following considerations apply:

Shopify queries the callback_url/fetch_tracking_numbers endpoint to retrieve tracking numbers for orders, if trackingSupport is set to true.

Shopify queries the callback_url/fetch_stock endpoint to retrieve inventory levels, if inventoryManagement is set to true.

Shopify uses the callback_url/fulfillment_order_notification endpoint to send fulfillment and cancellation requests.
Anchor to inventoryManagementinventoryManagement • BooleanDefault:false: Whether the fulfillment service manages product inventory and provides updates to Shopify.
Anchor to namename • String!required: The name of the fulfillment service.
Anchor to trackingSupporttrackingSupport • BooleanDefault:false: Whether the fulfillment service provides tracking numbers for packages.

Show

deprecated arguments Deprecated

Anchor to fulfillmentOrdersOptInfulfillmentOrdersOptIn • BooleanDeprecatedDefault:true: Whether the fulfillment service uses the fulfillment order based workflow for managing fulfillments.

As of 2022-07 API version, the fulfillment order based workflow is the only way to manage fulfillments. As the migration is now finished, the fulfillmentOrdersOptIn property is deprecated and is always set to true on correctly functioning fulfillment services.

The fulfillmentOrdersOptIn input field is deprecated and will be removed in the next API version. This API version makes it optional and defaults to true for a smooth migration experience. Do not set the fulfillmentOrdersOptIn argument, and you are ready for the next API version release. Migration period ended. Defaults to true.
Anchor to permitsSkuSharingpermitsSkuSharing • BooleanDeprecatedDefault:true: Whether the fulfillment service can stock inventory alongside other locations. The non-SKU sharing fulfillment services are now deprecated. In the version "2025-04", this argument will be removed and all new fulfillment services will support SKU sharing by default.

Was this section helpful?

Anchor to FulfillmentServiceCreatePayload returnsFulfillmentServiceCreatePayload returns

Anchor to fulfillmentServicefulfillmentService • FulfillmentService: The created fulfillment service.
Anchor to userErrorsuserErrors • [UserError!]!non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Create a new FulfillmentService
fulfillmentServiceCreate reference

Examples

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

mutation fulfillmentServiceCreate($name: String!, $callbackUrl: URL!) {

fulfillmentServiceCreate(name: $name, callbackUrl: $callbackUrl) {

fulfillmentService {

serviceName

callbackUrl

}

userErrors {

field

message

}

}`,

{

variables: {

"name": "example_fulfillment_service",

"callbackUrl": "https://callback.org/"

);

const data = await response.json();

mutation fulfillmentServiceCreate($name: String!, $callbackUrl: URL!) {
  fulfillmentServiceCreate(name: $name, callbackUrl: $callbackUrl) {
    fulfillmentService {
      id
      serviceName
      callbackUrl
    }
    userErrors {
      field
      message
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation fulfillmentServiceCreate($name: String!, $callbackUrl: URL!) { fulfillmentServiceCreate(name: $name, callbackUrl: $callbackUrl) { fulfillmentService { id serviceName callbackUrl } userErrors { field message } } }",
 "variables": {
    "name": "example_fulfillment_service",
    "callbackUrl": "https://callback.org/"
  }
}'

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(
  `#graphql
  mutation fulfillmentServiceCreate($name: String!, $callbackUrl: URL!) {
    fulfillmentServiceCreate(name: $name, callbackUrl: $callbackUrl) {
      fulfillmentService {
        id
        serviceName
        callbackUrl
      }
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
      "name": "example_fulfillment_service",
      "callbackUrl": "https://callback.org/"
    },
  },
);

const data = await response.json();

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation fulfillmentServiceCreate($name: String!, $callbackUrl: URL!) {
      fulfillmentServiceCreate(name: $name, callbackUrl: $callbackUrl) {
        fulfillmentService {
          id
          serviceName
          callbackUrl
        }
        userErrors {
          field
          message
        }
      }
    }`,
    "variables": {
      "name": "example_fulfillment_service",
      "callbackUrl": "https://callback.org/"
    },
  },
});

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation fulfillmentServiceCreate($name: String!, $callbackUrl: URL!) {
    fulfillmentServiceCreate(name: $name, callbackUrl: $callbackUrl) {
      fulfillmentService {
        id
        serviceName
        callbackUrl
      }
      userErrors {
        field
        message
      }
    }
  }
QUERY

variables = {
  "name": "example_fulfillment_service",
  "callbackUrl": "https://callback.org/"
}

response = client.query(query: query, variables: variables)

Input variables

JSON

{

"name": "example_fulfillment_service",

"callbackUrl": "https://callback.org/"

}

Response

JSON

{

"fulfillmentServiceCreate": {

"fulfillmentService": {

"id": "gid://shopify/FulfillmentService/1061774487?id=true",

"serviceName": "example_fulfillment_service",

"callbackUrl": "https://callback.org/"

"userErrors": []

}