Close menu
Explore Plans
Mobile menu Close menu
Back
Etsy for Sellers

Create a listing

This action will create a new listing as a draft in your Etsy shop.

Developer info

API endpoint slug
etsy.create_listing
Filter code method
Etsy.createListing.skip(string?: reason)
Runtime method
runAction("etsy.create_listing", {})

Action fields

Title Text input > Other

Label
Title
Helper text
The name of the item you're listing.
Slug
title
Required
true
Can have default value
true
Filter code method
Etsy.createListing.setTitle(string: title)

Description Text input > Long text

Label
Description
Helper text
Details about the item, shown to buyers.
Slug
description
Required
true
Can have default value
true
Filter code method
Etsy.createListing.setDescription(string: description)

Price Text input > Other

Label
Price
Helper text
The price for one unit of this item.
Slug
price
Required
true
Can have default value
true
Filter code method
Etsy.createListing.setPrice(string: price)

Quantity Text input > Other

Label
Quantity
Helper text
How many are available for sale.
Slug
quantity
Required
true
Can have default value
true
Filter code method
Etsy.createListing.setQuantity(string: quantity)

Who made Dropdown list

Label
Who made it
Helper text
Who made this item.
Slug
who_made
Required
true
Can have default value
true
Filter code method
Etsy.createListing.setWhoMade(string: who_made)

When made Text input > Other

Label
When it was made
Helper text
The time period this item was made in, using Etsy's own category for this (for example, made to order, or a specific decade). See Etsy's seller documentation for the exact list of accepted values.
Slug
when_made
Required
true
Can have default value
true
Filter code method
Etsy.createListing.setWhenMade(string: when_made)

Listing type Dropdown list

Label
Listing type
Helper text
Whether this is a physical item that ships, or a digital download.
Slug
listing_type
Required
true
Can have default value
true
Filter code method
Etsy.createListing.setListingType(string: listing_type)

Category Text input > Other

Label
Category
Helper text
The numeric Etsy category ID for this item. Find it by browsing Etsy's seller taxonomy or checking an existing listing's category.
Slug
category
Required
true
Can have default value
true
Filter code method
Etsy.createListing.setCategory(string: category)

Shipping profile Dropdown list

Label
Shipping profile
Helper text
Required for physical items — choose which shipping profile to use. Leave unselected for digital downloads.
Slug
shipping_profile
Required
false
Can have default value
false

Processing profile Text input > Other

Label
Processing profile
Helper text
Required for physical items — the numeric processing profile ID that sets how long this item takes to prepare for shipping. Leave blank for digital downloads.
Slug
processing_profile
Required
false
Can have default value
true
Filter code method
Etsy.createListing.setProcessingProfile(string: processing_profile)

Shop section Dropdown list

Label
Shop section
Helper text
Optionally, choose which shop section this listing belongs in.
Slug
shop_section
Required
false
Can have default value
false

Item weight Text input > Other

Label
Item weight
Helper text
Required for physical items whose shipping profile calculates cost by weight and size. Leave blank for digital downloads or a fixed-cost shipping profile.
Slug
item_weight
Required
false
Can have default value
true
Filter code method
Etsy.createListing.setItemWeight(string: item_weight)

Item weight unit Text input > Other

Label
Item weight unit
Helper text
The unit the item weight is given in, for example oz, lb, g, or kg. Required alongside item weight.
Slug
item_weight_unit
Required
false
Can have default value
true
Filter code method
Etsy.createListing.setItemWeightUnit(string: item_weight_unit)

Item length Text input > Other

Label
Item length
Helper text
Required for physical items whose shipping profile calculates cost by weight and size. Leave blank for digital downloads or a fixed-cost shipping profile.
Slug
item_length
Required
false
Can have default value
true
Filter code method
Etsy.createListing.setItemLength(string: item_length)

Item width Text input > Other

Label
Item width
Helper text
Required for physical items whose shipping profile calculates cost by weight and size. Leave blank for digital downloads or a fixed-cost shipping profile.
Slug
item_width
Required
false
Can have default value
true
Filter code method
Etsy.createListing.setItemWidth(string: item_width)

Item height Text input > Other

Label
Item height
Helper text
Required for physical items whose shipping profile calculates cost by weight and size. Leave blank for digital downloads or a fixed-cost shipping profile.
Slug
item_height
Required
false
Can have default value
true
Filter code method
Etsy.createListing.setItemHeight(string: item_height)

Item dimensions unit Text input > Other

Label
Item dimensions unit
Helper text
The unit the item's length, width, and height are given in, for example in or cm. Required alongside the dimension fields.
Slug
item_dimensions_unit
Required
false
Can have default value
true
Filter code method
Etsy.createListing.setItemDimensionsUnit(string: item_dimensions_unit)