The fulfillment order's assigned fulfillment service must be of api type

Technical Q&A

Topic summary

A user is encountering a 422 error when attempting to fulfill an order through the Shopify API. The error message states: “The fulfillment order’s assigned fulfillment service must be of api type.”

Technical Details:

  • Error occurs during the shipment process
  • API version: 2023-01
  • Shop ID: 65875247360

Likely Cause:
The fulfillment service configured for the order is set to “manual” type instead of “api” type. Shopify requires that when fulfilling orders programmatically via API, the associated fulfillment service must be configured as an API-integrated service.

Status:
The issue remains unresolved with no responses yet. The user is seeking assistance to understand why this error is occurring and how to resolve it.

Summarized with AI on November 14. AI used: claude-sonnet-4-5-20250929.
1

Hello, we encountered an issue during shipment and need your assistance.

“The fulfillment order’s assigned fulfillment service must be of api type。”,

What is the reason for this occurrence?

(code=422, body={“errors”:[“The fulfillment order’s assigned fulfillment service must be of api type”]}, header=[Date: Tue, 19 Dec 2023 02:48:08 GMT, Content-Type: application/json; charset=utf-8, Transfer-Encoding: chunked, Connection: keep-alive, X-Sorting-Hat-PodId: 255, X-Sorting-Hat-ShopId: 65875247360, Referrer-Policy: origin-when-cross-origin, X-Frame-Options: DENY, X-ShopId: 65875247360, X-ShardId: 255, X-Stats-UserId: , X-Stats-ApiClientId: 2592871, X-Stats-ApiPermissionId: 434144805120, X-Shopify-API-Version: 2023-01, X-Shopify-API-Version-Warning: About Shopify API versioning, HTTP_X_SHOPIFY_SHOP_API_CALL_LIMIT: 1/40, X-Shopify-Shop-Api-Call-Limit: 1/40, Strict-Transport-Security: max-age=7889238, Server-Timing: processing;dur=89, Content-Security-Policy: default-src ‘self’ data: blob: ‘unsafe-inline’ ‘unsafe-eval’ https://* shopify-pos://; block-all-mixed-content; child-src ‘self’ https:// shopify-pos://; connect-src ‘self’ wss:// https://; frame-ancestors ‘none’; img-src ‘self’ data: blob: https:; script-src https://cdn.shopify.com https://cdn.shopifycdn.net https://checkout.shopifycs.com https://api.stripe.com https://mpsnare.iesnare.com https://appcenter.intuit.com https://www.paypal.com https://js.braintreegateway.com https://c.paypal.com https://maps.googleapis.com https://www.google-analytics.com https://v.shopify.com ‘self’ ‘unsafe-inline’ ‘unsafe-eval’; upgrade-insecure-requests; report-uri /csp-report?source%5Baction%5D=create&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Ffulfillments&source%5Bsection%5D=admin_api&source%5Buuid%5D=15cd71a3-0f5c-4567-9236-27972200a25c, X-Content-Type-Options: nosniff, X-Download-Options: noopen, X-Permitted-Cross-Domain-Policies: none, X-XSS-Protection: 1; mode=block; report=/xss-report?source%5Baction%5D=create&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Ffulfillments&source%5Bsection%5D=admin_api&source%5Buuid%5D=15cd71a3-0f5c-4567-9236-27972200a25c, X-Request-ID: 15cd71a3-0f5c-4567-9236-27972200a25c, CF-Cache-Status: DYNAMIC, Report-To: {“endpoints”:[{“url”:“https://a.nel.cloudflare.com/report/v3?s=dEIMvTFd60CiqQ78BI6wUwpmnhzQTDc%2FtQzoMQhoFj2hod5X8D0eZ7l2rpfCdO2aEx%2FM5krcDlP%2BL94rbxuAOWtklGd3%2Fz4xTzjAbmRXhibO%2BF%2BNy6hTVHPUsj%2FuFmYfGvxfCEQkRM9H7VdH”}],“group”:“cf-nel”,“max_age”:604800}, NEL: {“success_fraction”:0.01,“report_to”:“cf-nel”,“max_age”:604800}, Server-Timing: cfRequestDuration;dur=161.000013, Server: cloudflare, CF-RAY: 837c532a0d8a964a-SJC, alt-svc: h3=“:443”; ma=86400], allHeader=[Date: Tue, 19 Dec 2023 02:48:08 GMT, Content-Type: application/json; charset=utf-8, Transfer-Encoding: chunked, Connection: keep-alive, X-Sorting-Hat-PodId: 255, X-Sorting-Hat-ShopId: 65875247360, Referrer-Policy: origin-when-cross-origin, X-Frame-Options: DENY, X-ShopId: 65875247360, X-ShardId: 255, X-Stats-UserId: , X-Stats-ApiClientId: 2592871, X-Stats-ApiPermissionId: 434144805120, X-Shopify-API-Version: 2023-01, X-Shopify-API-Version-Warning: About Shopify API versioning, HTTP_X_SHOPIFY_SHOP_API_CALL_LIMIT: 1/40, X-Shopify-Shop-Api-Call-Limit: 1/40, Strict-Transport-Security: max-age=7889238, Server-Timing: processing;dur=89, Content-Security-Policy: default-src ‘self’ data: blob: ‘unsafe-inline’ ‘unsafe-eval’ https:// shopify-pos://; block-all-mixed-content; child-src ‘self’ https:// shopify-pos://; connect-src ‘self’ wss:// https://*; frame-ancestors ‘none’; img-src ‘self’ data: blob: https:; script-src https://cdn.shopify.com https://cdn.shopifycdn.net https://checkout.shopifycs.com https://api.stripe.com https://mpsnare.iesnare.com https://appcenter.intuit.com https://www.paypal.com https://js.braintreegateway.com https://c.paypal.com https://maps.googleapis.com https://www.google-analytics.com https://v.shopify.com ‘self’ ‘unsafe-inline’ ‘unsafe-eval’; upgrade-insecure-requests; report-uri /csp-report?source%5Baction%5D=create&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Ffulfillments&source%5Bsection%5D=admin_api&source%5Buuid%5D=15cd71a3-0f5c-4567-9236-27972200a25c, X-Content-Type-Options: nosniff, X-Download-Options: noopen, X-Permitted-Cross-Domain-Policies: none, X-XSS-Protection: 1; mode=block; report=/xss-report?source%5Baction%5D=create&source%5Bapp%5D=Shopify&source%5Bcontroller%5D=admin%2Ffulfillments&source%5Bsection%5D=admin_api&source%5Buuid%5D=15cd71a3-0f5c-4567-9236-27972200a25c, X-Request-ID: 15cd71a3-0f5c-4567-9236-27972200a25c, CF-Cache-Status: DYNAMIC, Report-To: {“endpoints”:[{“url”:“https://a.nel.cloudflare.com/report/v3?s=dEIMvTFd60CiqQ78BI6wUwpmnhzQTDc%2FtQzoMQhoFj2hod5X8D0eZ7l2rpfCdO2aEx%2FM5krcDlP%2BL94rbxuAOWtklGd3%2Fz4xTzjAbmRXhibO%2BF%2BNy6hTVHPUsj%2FuFmYfGvxfCEQkRM9H7VdH”}],“group”:“cf-nel”,“max_age”:604800}, NEL: {“success_fraction”:0.01,“report_to”:“cf-nel”,“max_age”:604800}, Server-Timing: cfRequestDuration;dur=161.000013, Server: cloudflare, CF-RAY: 837c532a0d8a964a-SJC, alt-svc: h3=“:443”; ma=86400])