---
title: Serving errors on a fulfillment orders opt-out fulfillment service creation and modification - Shopify developer changelog
description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.
source_url:
  html: https://shopify.dev/changelog/serving-errors-on-a-fulfillment-orders-opt-out-fulfillment-service-creation-and-modification
  md: https://shopify.dev/changelog/serving-errors-on-a-fulfillment-orders-opt-out-fulfillment-service-creation-and-modification.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

January 1, 2023

Tags:

* Action Required
* API
* 2022-07

# Serving errors on a fulfillment orders opt-out fulfillment service creation and modification

[As of 2022-07 API version](https://shopify.dev/changelog/legacy-fulfillment-api-deprecation), it's mandatory for a fulfillment service to follow a fulfillment order based workflow and have `fulfillment_orders_opt_in` set to `true` in `FulfillmentService` resource. The last API version serving the legacy fulfillment APIs is **2022-04**.

With **2023-01** release, we add observability to the migration process.

Errors will be returned if a legacy (fulfillment orders opt-out) fulfillment service is intended to be created on an API version, where the legacy fulfillment APIs are not available.

Errors will be returned on fulfillment service create [REST](https://shopify.dev/api/admin-rest/2023-01/resources/fulfillmentservice#post-fulfillment-services) and [GraphQL](https://shopify.dev/api/admin-graphql/2023-01/mutations/fulfillmentServiceCreate) API calls if `fulfillment_orders_opt_in` field is not set into `true` in the parameters.

Errors will be returned on fulfillment service update [REST](https://shopify.dev/api/admin-rest/2023-01/resources/fulfillmentservice#put-fulfillment-services-fulfillment-service-id) and [GraphQL](https://shopify.dev/api/admin-graphql/2023-01/mutations/fulfillmentServiceUpdate) API calls if the fulfillment service being changed has `fulfillment_orders_opt_in` set to `false` and the update request does not promote `fulfillment_orders_opt_in` into `true`. `fulfillment_orders_opt_in` and `callback_url` become required parameters for fulfillment service create request/mutation.

Follow [Migrate to fulfillment orders](https://shopify.dev/apps/fulfillment/migrate) guide to learn how to migrate. Follow [Manage fulfillments as a fulfillment service app](https://shopify.dev/apps/fulfillment/fulfillment-service-apps/manage-fulfillments) guide to learn how to fulfill fulfillment orders.