--- title: fulfillmentServiceUpdate - GraphQL Admin description: |- Updates a fulfillment service. If you need to update the location managed by the fulfillment service (for example, to change the address of a fulfillment service), use the [LocationEdit](https://shopify.dev/api/admin-graphql/latest/mutations/locationEdit) mutation. api_version: 2025-10 api_name: admin type: mutation api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/mutations/fulfillmentServiceUpdate?example=modify-an-existing-fulfillmentservice md: https://shopify.dev/docs/api/admin-graphql/latest/mutations/fulfillmentServiceUpdate.md?example=modify-an-existing-fulfillmentservice --- # fulfillment​Service​Update mutation Requires `write_fulfillments` access scope. Also: The user must have fulfill\_and\_ship\_orders permission. Updates a fulfillment service. If you need to update the location managed by the fulfillment service (for example, to change the address of a fulfillment service), use the [LocationEdit](https://shopify.dev/api/admin-graphql/latest/mutations/locationEdit) mutation. ## Arguments * callback​Url [URL](https://shopify.dev/docs/api/admin-graphql/latest/scalars/URL) The URL to send requests for the fulfillment service. If `callbackUrl` is provided: * 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](https://shopify.dev/apps/fulfillment/fulfillment-service-apps/manage-fulfillments#step-2-receive-fulfillment-requests-and-cancellations). Otherwise, if no `callbackUrl` is provided you need to submit this information via the api: * For submitting tracking info and handling fulfillment requests, see our docs on [building for fulfillment services](https://shopify.dev/apps/build/orders-fulfillment/fulfillment-service-apps/build-for-fulfillment-services). * For managing inventory quantities, see our docs on [managing inventory quantities and states](https://shopify.dev/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states). * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required The id of the fulfillment service. * inventory​Management [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) Whether the fulfillment service manages product inventory and provides updates to Shopify. If `callbackUrl` is provided, 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](https://shopify.dev/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states). * name [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The name of the fulfillment service. * requires​Shipping​Method [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) Default:true Whether the fulfillment service requires products to be physically shipped. * tracking​Support [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) Whether the fulfillment service provides tracking numbers for packages. If `callbackUrl` is provided, 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](https://shopify.dev/apps/build/orders-fulfillment/fulfillment-service-apps/build-for-fulfillment-services). ### Deprecated arguments * fulfillment​Orders​Opt​In [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) Deprecated * permits​Sku​Sharing [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) Deprecated *** ## Fulfillment​Service​Update​Payload returns * fulfillment​Service [Fulfillment​Service](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentService) The updated fulfillment service. * user​Errors [\[User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/UserError) non-null The list of errors that occurred from executing the mutation. *** ## Examples * ### Modify an existing FulfillmentService #### Description A fulfillment service app updates the name of its fulfillment service. #### Query ```graphql mutation fulfillmentServiceUpdate($id: ID!, $name: String!) { fulfillmentServiceUpdate(id: $id, name: $name) { fulfillmentService { id serviceName } userErrors { field message } } } ``` #### Variables ```json { "id": "gid://shopify/FulfillmentService/198258461", "name": "My Updated Fulfillment Warehouse" } ``` #### cURL ```bash curl -X POST \ https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "mutation fulfillmentServiceUpdate($id: ID!, $name: String!) { fulfillmentServiceUpdate(id: $id, name: $name) { fulfillmentService { id serviceName } userErrors { field message } } }", "variables": { "id": "gid://shopify/FulfillmentService/198258461", "name": "My Updated Fulfillment Warehouse" } }' ``` #### React Router ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql mutation fulfillmentServiceUpdate($id: ID!, $name: String!) { fulfillmentServiceUpdate(id: $id, name: $name) { fulfillmentService { id serviceName } userErrors { field message } } }`, { variables: { "id": "gid://shopify/FulfillmentService/198258461", "name": "My Updated Fulfillment Warehouse" }, }, ); const json = await response.json(); return json.data; } ``` #### Ruby ```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 fulfillmentServiceUpdate($id: ID!, $name: String!) { fulfillmentServiceUpdate(id: $id, name: $name) { fulfillmentService { id serviceName } userErrors { field message } } } QUERY variables = { "id": "gid://shopify/FulfillmentService/198258461", "name": "My Updated Fulfillment Warehouse" } response = client.query(query: query, variables: variables) ``` #### Node.js ```javascript const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: { "query": `mutation fulfillmentServiceUpdate($id: ID!, $name: String!) { fulfillmentServiceUpdate(id: $id, name: $name) { fulfillmentService { id serviceName } userErrors { field message } } }`, "variables": { "id": "gid://shopify/FulfillmentService/198258461", "name": "My Updated Fulfillment Warehouse" }, }, }); ``` #### Response ```json { "fulfillmentServiceUpdate": { "fulfillmentService": { "id": "gid://shopify/FulfillmentService/198258461?id=true", "serviceName": "My Updated Fulfillment Warehouse" }, "userErrors": [] } } ``` * ### fulfillmentServiceUpdate reference [Open in GraphiQL](http://localhost:3457/graphiql?query=mutation%20fulfillmentServiceUpdate\(%24id%3A%20ID!%2C%20%24name%3A%20String!\)%20%7B%0A%20%20fulfillmentServiceUpdate\(id%3A%20%24id%2C%20name%3A%20%24name\)%20%7B%0A%20%20%20%20fulfillmentService%20%7B%0A%20%20%20%20%20%20id%0A%20%20%20%20%20%20serviceName%0A%20%20%20%20%7D%0A%20%20%20%20userErrors%20%7B%0A%20%20%20%20%20%20field%0A%20%20%20%20%20%20message%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D\&variables=%7B%0A%20%20%22id%22%3A%20%22gid%3A%2F%2Fshopify%2FFulfillmentService%2F198258461%22%2C%0A%20%20%22name%22%3A%20%22My%20Updated%20Fulfillment%20Warehouse%22%0A%7D) ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql mutation fulfillmentServiceUpdate($id: ID!, $name: String!) { fulfillmentServiceUpdate(id: $id, name: $name) { fulfillmentService { id serviceName } userErrors { field message } } }`, { variables: { "id": "gid://shopify/FulfillmentService/198258461", "name": "My Updated Fulfillment Warehouse" }, }, ); const json = await response.json(); return json.data; } ``` ##### GQL ``` mutation fulfillmentServiceUpdate($id: ID!, $name: String!) { fulfillmentServiceUpdate(id: $id, name: $name) { fulfillmentService { id serviceName } userErrors { field message } } } ``` ##### cURL ``` curl -X POST \ https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "mutation fulfillmentServiceUpdate($id: ID!, $name: String!) { fulfillmentServiceUpdate(id: $id, name: $name) { fulfillmentService { id serviceName } userErrors { field message } } }", "variables": { "id": "gid://shopify/FulfillmentService/198258461", "name": "My Updated Fulfillment Warehouse" } }' ``` ##### 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 fulfillmentServiceUpdate($id: ID!, $name: String!) { fulfillmentServiceUpdate(id: $id, name: $name) { fulfillmentService { id serviceName } userErrors { field message } } }`, { variables: { "id": "gid://shopify/FulfillmentService/198258461", "name": "My Updated Fulfillment Warehouse" }, }, ); 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 fulfillmentServiceUpdate($id: ID!, $name: String!) { fulfillmentServiceUpdate(id: $id, name: $name) { fulfillmentService { id serviceName } userErrors { field message } } }`, "variables": { "id": "gid://shopify/FulfillmentService/198258461", "name": "My Updated Fulfillment Warehouse" }, }, }); ``` ##### 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 fulfillmentServiceUpdate($id: ID!, $name: String!) { fulfillmentServiceUpdate(id: $id, name: $name) { fulfillmentService { id serviceName } userErrors { field message } } } QUERY variables = { "id": "gid://shopify/FulfillmentService/198258461", "name": "My Updated Fulfillment Warehouse" } response = client.query(query: query, variables: variables) ``` ## Input variables JSON ```json { "id": "gid://shopify/FulfillmentService/198258461", "name": "My Updated Fulfillment Warehouse" } ``` ## Response JSON ```json { "fulfillmentServiceUpdate": { "fulfillmentService": { "id": "gid://shopify/FulfillmentService/198258461?id=true", "serviceName": "My Updated Fulfillment Warehouse" }, "userErrors": [] } } ```