Choose a version:

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.

Anchor to Arguments

Arguments

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

If callbackUrl is provided (optional as of API version "2026-01"), 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 •Boolean Default:false: Whether the fulfillment service manages product inventory and provides updates to Shopify.

If callbackUrl is provided (optional as of API version "2026-01"), Shopify will periodically fetch inventory levels via the callback endpoint.

If no callbackUrl is provided you need to submit this information via the api, see our docs on managing inventory quantities and states.
Anchor to namename •String! required: The name of the fulfillment service.
Anchor to trackingSupporttrackingSupport •Boolean Default:false: Whether the fulfillment service provides tracking numbers for packages.

If callbackUrl is provided (optional as of API version "2026-01"), Shopify will periodically fetch tracking numbers via the callback endpoint.

If no callbackUrl is provided you need to submit this information via the api, see our docs on building for fulfillment services.

Deprecated arguments

Anchor to fulfillmentOrdersOptInfulfillmentOrdersOptIn •Boolean DeprecatedDefault:true
Anchor to permitsSkuSharingpermitsSkuSharing •Boolean DeprecatedDefault:true

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?

Examples

Create a new FulfillmentService

Description

A third party app creates a fulfillment service that uses the fulfillment order based workflow.

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/"
}

cURL

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/"
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  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 json = await response.json();
  return json.data;
}

Ruby

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)

Node.js

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/"
    },
  },
});

Response

{
  "fulfillmentServiceCreate": {
    "fulfillmentService": {
      "id": "gid://shopify/FulfillmentService/1061774487?id=true",
      "serviceName": "example_fulfillment_service",
      "callbackUrl": "https://callback.org/"
    },
    "userErrors": []
  }
}

fulfillmentServiceCreate reference

Examples

Open in GraphiQL

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

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 json = await response.json();

return json.data;

}

GQL

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

cURL

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/"
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  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 json = await response.json();
  return json.data;
}

Node.js

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/"
    },
  },
});

Ruby

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": []

}