Skip to main content

Syncing AfterShip Checkpoint Events to Shopify

Syncing AfterShip Checkpoint Events to Shopify: follow setup steps, configure key options, verify behavior, and troubleshoot workflow issues.

Written by Harneet Kaur

Plan: All plans Platform: Shopify

Overview

This guide explains how to sync the latest shipment checkpoint events from AfterShip to Shopify so your store always reflects the most recent shipment status. By pushing checkpoint updates directly into Shopify, you keep merchants and customers informed throughout the delivery lifecycle.

This integration uses Shopify’s GraphQL Admin API, specifically the FulfillmentEventInput object. For reference, see Shopify’s Admin API Documentation.

Note: Starting November 19, 2026, this feature is available on all AfterShip plans for Shopify stores. See Who can use it below to check whether it’s already on for your store.

Your Shopify store must have the write_fulfillments permission granted to AfterShip

  • New stores: This permission is granted automatically when you install the AfterShip app. No action is needed.

  • Existing stores: If you connected your store earlier, AfterShip may not have this permission yet. You don’t need to reinstall the app. Reauthorize your store instead:

    1. In AfterShip, go to your connection list.

    2. Find your Shopify store and click Reauthorize.
      ​

    3. Review and approve the updated permissions in Shopify.
      ​

Who can use it

Whether the sync is on for your store by default depends on when you connected your Shopify store to AfterShip and on your AfterShip plan.

Your Shopify store

Sync status

What to do

Connected on or after November 19, 2026, including stores that reconnect

On by default

Nothing. The sync works automatically.

Connected before November 19, 2026, on an Enterprise plan or above

On by default

Nothing

Connected before November 19, 2026, on a plan below Enterprise

Off by default

Reinstall the AfterShip Tracking app from your Shopify admin (uninstall it, then install it again), or contact Support to turn it on without reinstalling.

The sync works when all of the following are true:

  • Your Shopify store is connected to AfterShip.

  • AfterShip has the write_fulfillments permission on your store (see Overview).

  • The shipment comes from a Shopify order and matches a Shopify fulfillment.

How it works

  • AfterShip sends Shopify only the checkpoint events created after the sync is on for your store. AfterShip doesn’t sync earlier events automatically. If you need earlier events synced, contact Support.

  • AfterShip sends updates at a pace that leaves plenty of your store’s Shopify API capacity for your other apps. During peak traffic, some updates may reach Shopify slightly later than usual. AfterShip never drops updates, and each shipment’s updates always arrive in the correct order.

  • AfterShip syncs the same statuses on every plan (see Status mapping).

  • There’s no in-app setting to turn the sync off or choose statuses yet. If you need the sync turned off for your store, contact Support.

Primary use cases

  • Update Shopify whenever an AfterShip shipment checkpoint status changes.

  • Maintain a centralized view of fulfillment progress in Shopify.

  • Trigger Shopify automations using real-time shipping updates.

Field mapping

Important: Do not write back Expired events. AfterShip’s Expired status has no suitable Shopify equivalent field to map.

AfterShip Tracking Field

Shopify FulfillmentEventInput Field

Nullable

checkpoint-datetime

happenedAt

Yes

checkpoint-message

message

Yes

checkpoint-status

status

No

Status mapping

AfterShip Status

Shopify Status

Mapping Logic

InfoReceived

LABEL_PRINTED

InfoReceived > LABEL_PRINTED

InTransit

IN_TRANSIT

InTransit > IN_TRANSIT

OutForDelivery

OUT_FOR_DELIVERY

OutForDelivery > OUT_FOR_DELIVERY

AttemptFail

ATTEMPTED_DELIVERY

AttemptFail > ATTEMPTED_DELIVERY

Delivered

DELIVERED

Delivered > DELIVERED

AvailableForPickup

READY_FOR_PICKUP

AvailableForPickup > READY_FOR_PICKUP

Exception- Failure

FAILURE

Exception > FAILURE

Expired

N/A

Do not sync

Pending

CONFIRMED

Pending > CONFIRMED

Exception-Delayed

DELAYED

Exception > DELAYED

Special case handling

1. Multiple tracking numbers per fulfillment

  • When a single fulfillment includes multiple tracking numbers with different statuses, choose the status with the highest priority from the list below.

Priority order (highest > lowest):

  1. Exception

  2. Pending

  3. InfoReceived

  4. InTransit

  5. OutForDelivery

  6. AvailableForPickup

  7. AttemptFail

  8. Delivered

  • Use the top-priority status as the one to write back to Shopify.

2. Multiple updates with the same status

Only write back to Shopify when the shipment’s checkpoint status actually changes.

  • Write back when the status changes, even if the new status is earlier (i.e., a regression)

  • Do not write back repeated events with the same status

  • This prevents unnecessary updates and API noise

What does it look like on Shopify

  • We do map with Shopify status Label_PRINTED and CONFIRMED, but Shopify will not display these two statuses on the page.

  • After enabling the feature, we will start to push the tracking events to your Shopify stores, and they will be displayed on your order dashboard.

FAQs

1. Is this feature available on my plan?

Yes. It’s available on all AfterShip plans for Shopify stores.
​

2. Shopify orders aren’t updating. What should I check?

First, make sure AfterShip has the write_fulfillments permission. If it doesn’t, reauthorize your store from the connection list. If you connected your store before November 19, 2026, on a plan below Enterprise, the sync is off by default. Reinstall the AfterShip app or contact Support to turn it on. AfterShip syncs only shipments that come from Shopify orders.
​

3. Will orders that were already in transit or delivered be updated?

Not automatically. AfterShip syncs only new checkpoint events created after the sync is on. If you need earlier events synced for these orders, contact Support.

4. Can I turn off the sync or choose which statuses are synced?

Not in the app yet. Contact Support if you want the sync turned off for your store.

5. Why does an update sometimes show up in Shopify a little later?

To protect your store’s Shopify API capacity, AfterShip may briefly queue updates during peak traffic. AfterShip never drops them, and they always arrive in order.

Conclusion

This integration lets AfterShip push precise, real-time shipment updates into Shopify. By following the field mapping, status mapping, and prioritization rules above, you ensure reliable, clean, and automation-ready fulfillment events inside the Shopify Admin.

If you have any questions, contact our chat support team or email us at [email protected].

Did this answer your question?