Overview

Etsy is the global handmade + vintage + craft marketplace. The Automize Etsy connector covers listings, orders, shops, receipts, reviews, shipping for marketplace sellers.

Regions: Global.
Plans: Etsy shop required. API access free for sellers.

Setting up the connection

Auth type: OAuth 2.0 (Authorization Code).

Etsy developers → register app → OAuth credentials.
In Automize → Settings → Connectors → Etsy. Paste credentials, connect shop.

Find your credentials at https://www.etsy.com/developers/your-apps.

Rate limits

10 req/sec per token. Daily caps.

Data model

Marketplace primitives:

    Shop ─┬─ Listings (products)
          ├─ Orders ── Receipts ── Items
          └─ Reviews

Available operations

9 operations available. Click any row to jump to its detail.

Operation	Category	What it does
Create Listing	General	Create a new listing
Create Shipping Profile	General	Create a shipping profile
Get Listing	General	Get listing details
Get Receipt	General	Get receipt details
Get Shop	General	Get shop details
List Listings	General	List active shop listings
List Receipts	General	List shop receipts/orders
List Reviews	General	List shop reviews
Update Listing	General	Update an existing listing

Operations

Create Listing

Create a new listing

Parameter	Required	Type
Title `title`	Yes	text
Description `description`	Yes	text
Price `price`	Yes	number
Quantity `quantity`	Yes	number
Taxonomy Id `taxonomy_id`	Yes	text
Who Made `who_made`	Yes	text
When Made `when_made`	Yes	text
Is Supply `is_supply`	Yes	text
Shop Id `shop_id`	Yes	text

Tips

Heavy payload – title, description, price, quantity, images, tags, materials, shipping profile.

Create Shipping Profile

Create a shipping profile

Parameter	Required	Type
Title `title`	Yes	text
Origin Country Iso `origin_country_iso`	Yes	text
Primary Cost `primary_cost`	Yes	text
Secondary Cost `secondary_cost`	Yes	text
Shop Id `shop_id`	Yes	text

Get Listing

Get listing details

Parameter	Required	Type	Description
Listing Id `listing_id`	Yes	text

Get Receipt

Get receipt details

Parameter	Required	Type	Description
Shop Id `shop_id`	Yes	text
Receipt Id `receipt_id`	Yes	text

Get Shop

Get shop details

Parameter	Required	Type	Description
Shop Id `shop_id`	Yes	text

List Listings

List active shop listings

Parameter	Required	Type	Description
Shop Id `shop_id`	Yes	text

Tips

Active or all states (active, inactive, draft, expired, sold_out).

List Receipts

List shop receipts/orders

Parameter	Required	Type	Description
Shop Id `shop_id`	Yes	text

List Reviews

List shop reviews

Parameter	Required	Type	Description
Shop Id `shop_id`	Yes	text

Update Listing

Update an existing listing

Parameter	Required	Type
Title `title`	Yes	text
Description `description`	Yes	text
Price `price`	Yes	number
Quantity `quantity`	Yes	number
Shop Id `shop_id`	Yes	text
Listing Id `listing_id`	Yes	text

FAQ

Listing renewals?: Etsy listings expire after 4 months. Auto-renewal costs $0.20 each – manage via Update Listing.

Etsy integration