Nexra
All connectors
Implemented
Commerce, marketplaces & inventory
Etsy logo

Etsy

Read an Etsy shop, listings, inventory, receipts, transactions, shipping profiles and reviews; create draft listings, update listings and inventory, and add tracking to receipts.

Keep Etsy listings and stock in step with your catalogue and send Etsy orders and tracking through fulfilment and bookkeeping flows.

Build a flow with EtsyProvider API documentation

Source actions

10

Destination actions

4

Data types

9

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

listing inventory
  • Get listing inventory
    Source

    Products (SKU and property values) with offerings (price, quantity, enabled).

    listing_inventory.get
  • Update listing inventory
    Destination
    Provider duplicate protection
    Approval before production

    Replace a listing's products and offerings (SKU, price, quantity) — send every product.

    listing_inventory.update
listings
  • Create draft listing
    Destination
    Not retried automatically
    Approval before production

    Create a draft listing (activate it later with an update once it has images).

    listings.create
  • Get listing
    Source

    One listing with images and shipping details.

    listings.get
  • List shop listings
    Source

    Listings by state (active, inactive, draft, expired or sold out), recently updated first.

    listings.list
  • Update listing
    Destination
    Provider duplicate protection
    Approval before production

    Update listing details or state; price and quantity only when mapped.

    listings.update
receipt shipments
  • Add tracking to receipt
    Destination
    Not retried automatically
    Approval before production

    Add a carrier and tracking code to a receipt and notify the buyer.

    receipt_shipments.create
receipts
  • Get receipt
    Source

    One receipt with transactions and shipments.

    receipts.get
  • List receipts (orders)
    Source
    Incremental

    Shop receipts modified since a date, optionally paid or shipped only.

    receipts.list
reviews
  • List shop reviews
    Source
    Incremental

    Buyer reviews with rating and text, optionally created since a date.

    reviews.list
shipping profiles
  • List shipping profiles
    Source

    Shipping profiles with origin, processing times and destinations.

    shipping_profiles.list
shops
  • Get shop
    Source

    Shop profile, currency, active listing count and policies.

    shops.get
transactions
  • List transactions
    Source

    Sold line items for the shop, or for one receipt.

    transactions.list
users
  • Get authorised user
    Source

    The authorised user's ID and shop ID.

    users.get

Authentication

OAuth 2.0 (PKCE) refresh token plus x-api-key

Plans and access

Any Etsy seller with an approved Open API v3 app (personal access is enough for your own shop). Scopes: shops_r, listings_r, listings_w, transactions_r, transactions_w and email_r for buyer email.

Test environment

Etsy has no sandbox; test against a shop with draft listings.

Rate limits

Per API key: queries per second and a rolling 24-hour quota (commonly 10 QPS and 10,000 per day). x-limit-per-second, x-remaining-this-second, x-limit-per-day and x-remaining-today headers; HTTP 429 with retry-after.

Pagination

limit (max 100) and offset with count.

Provider events

Order paid and other shop webhooks (beta). Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

  • Etsy rotates refresh tokens; a token unused for 90 days expires and the shop must re-authorise.
  • Listing deletes, refunds and cancellations are not implemented. Listing images and files are not uploaded.
  • Listings with variations must change price and quantity through the inventory update, which replaces all products.
  • Etsy documents no idempotency key; draft listing creation and tracking uploads are not repeated automatically when uncertain.
  • Draft listing and listing updates are form-encoded; arrays (tags, materials) are sent comma-separated.

Developer reference

  1. Create the Etsy credentials described above with the narrowest permissions your flows need.
  2. In Nexra, open Connect, then Connections, then New connection, choose Etsy, enter its settings and credentials, and tick only the write actions you need. Connection guide
  3. Test the connection, then use its actions as flow sources and destinations. Flow guide
Etsy docsAPI referenceEtsy docsAuthenticationEtsy docsRate limitsEtsy docsWebhooks

Machine-readable detail: GET /api/public/connect/connectors/etsy and the Connections API.