Skip to content

API Quickstart

In this section, you will find a step-by-step guide to quickly start using the ThredUp API.

Prerequisites

Before you can start using the API, make sure you have the following:

  • A ThredUp account configured for the Sandbox environment
  • An active API key associated with your Sandbox account

Note

The Sandbox environment is intended for development and testing purposes. It allows you to experiment with the API without affecting production data.

Authentication

All API requests must include a valid authentication token. To authenticate, pass your token in the X-Thredup-Access-Token header of each request:

X-Thredup-Access-Token: at1b07...

Authentication tokens are issued by ThredUp. Please contact your ThredUp representative to request access to a valid token for the Sandbox or Production environment.

If a request is sent without a valid token, the API will respond with a 401 Unauthorized status code.

Warning

Tokens are environment-specific. Ensure you are using the correct token for the environment you are targeting (e.g., Sandbox vs. Production).

Making Your First Requests

Start with these three basic steps to begin interacting with the ThredUp API:

List an Item : Publish a new item to make it available to customers for purchase.

Retrieve Orders : View customer orders after an item has been purchased.

Fulfill an Order : Create a shipment and update its delivery status.

Next Steps

Once you have completed the API Quickstart examples, you are ready to explore more advanced functionality and integrations.

Refer to the API Reference for complete endpoint details and response formats.