Product update (Etsy)

Updating an Etsy Product

When updating a product on Etsy, here are some important details to keep in mind:

1. Include the taxonomyId Field

The taxonomyId field must be included when updating a product.

2. Add At Least One Image to Set the Product to Active Status

To set a product to active status, it must have at least one image. You can upload an image using the following endpoint:
POST /api/v2/products/{productID}/images

For more details, refer to the Add Product Images Documentation.

3. Valid Values for the whoMade and whenMade Fields

• whoMade Field: Use one of these values: "i_did", "someone_else", or "collective".

• whenMade Field: Valid values include:

  • "made_to_order"

  • "2020_2022", "2010_2019", "2003_2009", "2000_2002", "1990s", "1980s", and so on, all the way back to "before_1700".

4. isSupply Field Requirement

When updating a product for the first time with whoMade and whenMade, Etsy also requires the isSupply property to be included.

If the isSupply property is missing, you may encounter this error:

{
  "details": "{\"error\":\"Cannot update 'when_made' without 'who_made' and without 'is_supply' and vice versa\"}"
}

Once the isSupply field is set during the initial update, it won’t be required for future updates to the same product.

5. Mandatory policies.returns.id Field

Etsy requires the policies.returns.id field to be included in your update. You can set it to 1 for Etsy’s default return policy, or use the appropriate ID if your store has custom return policies.

6. You’ll need to include the pickupOptionId property when updating physical products.

For additional information, refer to the e-commerce resource documentation.