HomeDocumentationAPI Reference
Documentation

Adding support for multiple fulfillment locations

Improve the accuracy of order details and tax information by enabling warehouse detection.

This guide explains how to update Reach's access scopes in Shopify to enable warehouse detection, improving the accuracy of order details and tax information.

Already done?

If you have already set up your Reach Data app with the following access scopes, warehouse detection is enabled and there is no need to complete these steps:

  • read_assigned_fulfillment_orders
  • read_merchant_managed_fulfillment_orders
  • read_third_party_fulfillment_orders
  • read_locations

To add support for multiple fulfillment locations, complete the following steps:

  1. Sign in to your Shopify admin.
  2. Click Settings and then click Apps and sales channels.
  3. Click Develop Apps.

Click Develop apps

  1. Type Reach in the Filter items field under Legacy custom apps and click Sort. Then click the Reach Data app.

Click Reach Data

  1. Click the Configuration tab from the Overview tab on the Reach Data page.
  1. Click Edit in the Admin API integration section.

Click Edit

  1. Under Admin API access scopes, use the Filter access scopes field to locate and select the following checkboxes.
    • read_assigned_fulfillment_orders
    • read_merchant_managed_fulfillment_orders
    • read_third_party_fulfillment_orders
    • read_locations

Use the Filter access scopes field to locate checkboxes

  1. Click Save. Your Admin API access scopes will appear under the Admin API integration section in the Configuration tab.

API access scopes will appear under Admin API integration

  1. Click Edit in the Admin API integration section.
  2. Scroll down to Webhook subscriptions on the Configuration tab.
  3. Click the Event version dropdown and select 2025-07.

Select 2025-07 from the Event version dropdown

You have successfully added the required access scopes to enable support for multiple fulfillment locations.

Please inform your Account Manager

Please let your Account Manager know you've completed these steps, or send an email to [email protected].