Set Up Real-Time Notifications

Subscribe to FULFILLMENT_ORDER_STATUS notifications to receive real-time updates as your order moves through fulfillment. This eliminates repeated polling of getOrder. Three event types are emitted: ORDER_STATUS_CHANGED, SHIPMENT_STATUS_CHANGED, and SHIPMENT_PACKAGE_STATUS_CHANGED.

Step 1. Create a destination

Call the createDestination operation of the Notifications API to register the SQS queue or webhook endpoint where you want to receive notifications.

Save the destinationId from the response.

Step 2. Subscribe to FULFILLMENT_ORDER_STATUS

Call the createSubscription operation of the Notifications API with notificationType set to FULFILLMENT_ORDER_STATUS to subscribe to the FULFILLMENT_ORDER_STATUS notification.

You receive a notification whenever an order, shipment, or package changes status. Check eventType in the response to route to the correct handler: ORDER_STATUS_CHANGED, SHIPMENT_STATUS_CHANGED, or SHIPMENT_PACKAGE_STATUS_CHANGED.

📘 Note: Notifications are not sent for sandbox orders. Use getOrder or the sandbox-only updateOrderStatus operation during testing.