Orders

Orders are created automatically by the platform when a customer places an order for one or more items on ThredUp.

Note

Orders cannot be created via the API

Partners can access these orders via the Orders API.

To track new or updated orders, partners can either poll the API or use webhooks to receive push notifications.

Polling for new orders

Various filters can be used when polling for new orders (e.g. filtering by created_at or updated_at dates).

For example, the partner can fetch all orders that have updated_at date after the previous sync to receive all updates to orders: new orders and orders that were canceled or refunded since the previous sync date.

Webhooks for new orders

Instead of polling, you can subscribe to webhook events and receive instant updates when an order changes.

The following order related webhook events are available: - order created: when a new order is placed and passed the fraud check - order canceled: when an order is canceled by the customer or ThredUp - order refunded: when an order is refunded by ThredUp - order address updated: when an order address is updated by ThredUp at the request of the customer

For implementation details, see the Webhooks section.