Create new listings on Etsy

[YamunaSri]

Hi all,

I’m working with the Etsy API to create and manage listings. I’m facing an issue where my listing shows the message “Sorry, this item is unavailable” on Etsy.com, even though:

• The listing state is active ("state": "active")
• I have uploaded images (confirmed via the API)
• I have set inventory with quantity and price
• Shipping profile is set and valid
• The readiness_state_id matches the only valid one from the shop’s readiness states (ready_to_ship)

However, when I query the listing via the API:

• "images": null
• "inventory": null

I have verified via the following endpoints:

• GET /application/shops/{shop_id}/listings/{listing_id}/images returns [] (empty array)
• GET /application/listings/{listing_id}/inventory returns null or empty

I’ve tried re-uploading images using the exact listing ID and re-posting inventory without product_id or offering_id fields, but the data still doesn’t appear linked.

Could anyone advise if there’s a known delay or additional steps required to properly link images and inventory to a listing? Or any tips on how to debug this?

Thanks in advance!

---

API calls I’m using:

• Upload images:
  POST /application/shops/{shop_id}/listings/{listing_id}/images

• Update inventory:
  PUT /application/listings/{listing_id}/inventory

• Set readiness state:
  PUT /application/listings/{listing_id} with { "readiness_state_id": xxxxx }

---

Additional info:

• Shop is active and not in vacation mode
• Shipping profile allows domestic shipping from US to US
• Listing has a valid taxonomy ID
• Using OAuth2 with all correct scopes

---

Would appreciate any pointers!

[openapi-support[bot]]

Hi there, could you provide a listing ID as an example so we could reproduce this issue?