> ## Documentation Index
> Fetch the complete documentation index at: https://docs.daoco.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Etsy

> Connect your Etsy shop through your own Etsy seller app so Daoco can read your listings, orders, and reviews, and improve listings with your approval.

Etsy is a **Dev Testing** integration while it is being tested. Your shop connects through an Etsy **seller app** that you create for your own shop. Etsy's sign-in screen names your app, not Daoco. Daoco stores your app's keystring and shared secret encrypted for this brand, sends them only to Etsy, and calls Etsy's Open API directly.

A workspace owner or admin must first turn on **Dev Testing integrations** in **Settings** → **Preview features**. Etsy then appears under **Dev Testing** in **Connections** → **Integrations** → **Add integration**. Connect one shop per brand. To use the same shop with another brand, connect it there too, with the same app or a new one.

## What Daoco can do

* Read your shop: name, announcement, sale message, sales count, favorers, and review average.
* Read your listings in any state (active, draft, inactive, sold out, expired) with views, favorers, tags, sections, and photos.
* Read your orders: dates, status, totals, sales tax and VAT, items, and destination country. Revenue Daoco reports is what buyers kept paying after refunds, less the sales tax and VAT Etsy collects. Etsy does not say how much tax a partial refund returned, so revenue on a partly refunded order is an estimate.
* Read your reviews, and any shop's public reviews and active listings, and search all of Etsy for market and competitor research.
* Edit a listing's title, description, tags, materials, or section, and add a photo with alt text. A new photo goes after the listing's other photos unless you ask for a position, such as the main photo.

Edits to a draft, inactive, or expired listing are ordinary changes. Edits to a live listing (active or sold out) and new photos change what shoppers see, so Daoco treats them like publishing. Your [approval preferences](https://docs.daoco.org/account-and-billing/approval-preferences.md) decide whether you are asked first.

## Limits

* Daoco does not activate, renew, deactivate, or delete listings, or change prices or stock. Etsy charges a listing fee to activate or renew a listing, so do those in Etsy.
* Daoco does not message buyers.
* Order reads leave out buyer names, addresses, emails, and messages.
* Etsy limits a title to 140 characters and a listing to 13 tags of at most 20 characters each. Tags hold only letters, numbers, spaces, `-`, and `'`. Daoco checks these before it sends a change, and a tag change replaces the whole set.
* Each Etsy app has its own request limit. Daoco reads at most 100 listings, orders, or reviews per request, so a very large shop takes several requests.
* A seller app reaches only the shop of the Etsy account that created it. Each shop owner creates their own app.

## Before you start

* Sign in to Etsy with the account that **owns the shop**. Daoco connects the shop of the account you sign in with.
* In Daoco, select the brand that should use this shop. Only a brand's owner or a workspace admin can save Etsy's keys.
* Allow pop-ups for Daoco. Etsy's sign-in opens in a new window.

## Connect your Etsy seller account

**1. Enable Dev Testing**

A workspace owner or admin turns on **Dev Testing integrations** in **Settings** → **Preview features**.

**2. Open the Etsy card in Daoco**

In Daoco, open **Connections**, choose the **Integrations** tab, choose **Add integration**, and pick **Etsy** under **Dev Testing**. Keep this card open; you need its **OAuth redirect URI** in step 4.

**3. Create a seller app in Etsy**

Open [etsy.com/developers/register-seller-app](https://www.etsy.com/developers/register-seller-app) while signed in as the shop owner.

Create a **seller app**, not a personal app. A seller app reaches only your own shop, and Etsy approves eligible sellers within minutes. The personal app form (`etsy.com/developers/register`) sends your app to Etsy for a longer review and is the wrong form for this connection.

| Etsy field | What to enter |
| - | - |
| App name | Anything you will recognize, such as `Daoco for <your shop>`. |
| Describe your application (500 characters at most) | `Connects my own Etsy shop to Daoco, the marketing tool I use. It reads my shop, listings, views, favorites, orders, and reviews to plan marketing, and updates listing titles, descriptions, tags, materials, sections, and photos only after I approve each change. It never messages buyers, changes prices or stock, activates or renews listings, or stores buyer names, addresses, or emails. Used only for my shop. Scopes: shops_r, listings_r, listings_w, transactions_r.` |

Fill in anything else the form asks about your shop, accept Etsy's API terms, and create the app. **Manage your apps** at [etsy.com/developers](https://www.etsy.com/developers) shows when Etsy has approved it. The key does not work before then.

**4. Add Daoco's redirect URI to the app**

On the Daoco Etsy card, copy the **OAuth redirect URI** with the button at the end of the field.

In Etsy, open **Manage your apps**, open your app, and add that address as a **callback URL**. Paste it exactly: Etsy matches it character for character, so a missing `https://` or an extra `/` at the end makes sign-in fail.

![Daoco Connect Etsy card showing the OAuth redirect URI field, its copy button, and the four setup steps](https://mintcdn.com/daoco/904iw-7dHBjpal67/images/connections/etsy/daoco-redirect-uri.png?fit=max\&auto=format\&n=904iw-7dHBjpal67\&q=85\&s=d5611d6e4968dc702e2108e7b42002e9)

Copy the OAuth redirect URI with the button at the end of the field. Yours shows your own Daoco address.

**5. Copy the keystring and shared secret**

In **Manage your apps**, find your app. Copy the **keystring**, then click the eye icon next to **shared secret** to reveal it and copy it.

Treat the shared secret like a password. Paste it only into the Daoco Etsy card, never into a chat, a ticket, or an email.

**6. Save and connect**

On the Etsy card, paste the keystring into **Etsy keystring** and the shared secret into **Etsy shared secret**, then choose **Save and connect**.

![Daoco Connect Etsy card with the Etsy keystring and Etsy shared secret fields filled in and the Save and connect button](https://mintcdn.com/daoco/904iw-7dHBjpal67/images/connections/etsy/daoco-keys.png?fit=max\&auto=format\&n=904iw-7dHBjpal67\&q=85\&s=4b373905dfcc62cffdd78b45ac2f9d40)

Paste the keystring on the left and the shared secret on the right, then choose Save and connect.

Etsy opens in a new window. Sign in as the shop owner if Etsy asks, check that the shop is yours, and allow access. You return to Daoco, and the card shows **Etsy: `<your shop name>`**.

![Etsy sign-in page shown after choosing Save and connect](https://mintcdn.com/daoco/904iw-7dHBjpal67/images/connections/etsy/etsy-sign-in.png?fit=max\&auto=format\&n=904iw-7dHBjpal67\&q=85\&s=337a72f1a7e55729ae85414cb9d7feb5)

If you are not signed in to Etsy, it asks you to sign in first.

If no window opens, allow pop-ups for Daoco, paste the shared secret again, and choose **Save and connect**. Until Etsy is connected, the card keeps asking for the keys, and saving replaces the ones saved before.

**7. Verify from chat**

Ask Daoco for your five most-viewed active Etsy listings. It answers from your shop with each listing's views and favorers.

## Try it

* `Which of my Etsy listings get views but no orders, and why?`
* `Rewrite the tags on my top 5 Etsy listings for search. Show me before you change anything.`
* `Search Etsy for "moon phase print" and compare the top shops' prices and titles with mine.`
* `/store-review` for a ranked review of what sells and who buys.

## Disconnect

Disconnect Etsy from its card in **Connections**. Daoco deletes the connection and the saved keystring and shared secret, which ends Daoco's access. Your seller app stays in Etsy under **Manage your apps**; delete it there to end its access everywhere.

To use different keys, for example after you regenerate the shared secret in Etsy, disconnect Etsy in Daoco, then paste the new keystring and shared secret and connect again.

## Troubleshooting

> [accordion] Etsy says the redirect URI or callback URL is invalid
>
> The callback URL on your Etsy app must match the **OAuth redirect URI** on the Daoco card exactly, including `https://` and with no trailing `/`. Copy it again with the copy button, save it on the app, and choose **Save and connect** again.

> [accordion] I landed on a form that says Etsy will review my description
>
> That is the personal app form. Go to [etsy.com/developers/register-seller-app](https://www.etsy.com/developers/register-seller-app) and create a seller app instead.

> [accordion] This Etsy account has no shop
>
> You signed in to Etsy with an account that doesn't own a shop. Sign out of Etsy, sign in as the shop owner, and connect again.

> [accordion] Etsy refused the request (403), or the key is not active
>
> Etsy may not have approved the app yet. Check its status under **Manage your apps**. If it is approved, the keystring or shared secret may be wrong or regenerated. If this happened while connecting, the Etsy card asks for the keys again: paste the current values and choose **Save and connect**. If Etsy was already connected, disconnect Etsy in Daoco first, then paste the current values and connect again.

> [accordion] Etsy's rate limit was reached
>
> Each Etsy app has its own request limit. Wait a minute and ask again.

See Etsy's [Open API documentation](https://developers.etsy.com/documentation) and [authentication guide](https://developers.etsy.com/documentation/essentials/authentication) for Etsy's own requirements.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.