Connect Etsy to Craftybase
Learn how Craftybase pulls your Etsy data.
This article will guide you through how to connect to Etsy and what types of data we can pull into your Craftybase account.
Etsy is a third-party e-commerce platform that makes it easier for small creators and businesses to expand their reach.
Our Etsy ➝ Craftybase integration allows you to automatically pull your products and orders so your inventory levels always reflect your latest Etsy sales.
In this article:
- How to connect your Etsy shop
- How we pull data from Etsy
- Pulling your Etsy Listings
- Pulling your Etsy orders
- Pulling your Etsy fees
- Pulling your purchases from Etsy
- FAQs
How to connect your Etsy shop
To connect your Etsy store to Craftybase:
- Go to your Integrations page
- Locate the Etsy section and click the Connect button
- You’ll be redirected to Etsy to authorize the Craftybase app. Follow the on-screen steps to confirm the connection.
- Once connected, you’ll return to your Integrations page, where your Etsy shop name and next scheduled data pull will appear.
We request only the minimum access necessary to provide the integration and can only access data you’ve granted permission for. You can revoke this access at any time from your Etsy account settings.
How we pull data from Etsy
Once you have successfully created your connection, data pulls from Etsy will occur automatically each day at 5 a.m. in your local time zone. You can also run a manual data pull, if required, between the daily scheduled data pulls.
Your first data pull will attempt to pull all available data from your Account Start Date.
Note: Regardless of the date range selected, Craftybase will pull all listings found on Etsy and create these as products as they are required for linking to past and future orders/fees. If you do not wish to track some of these products, you can archive these and they will be removed from most views and reports.
We recommend creating new products directly on Etsy first, then importing them into Craftybase. This approach ensures your listings are structured correctly and helps minimize manual cleanup later.
Pulling your Etsy listings
Listings from Etsy will be pulled into Craftybase as both Products and Listings.
The current status of the listing on Etsy will be used only on the very first pull to set the default status for the product in Craftybase:
| Etsy Status | Craftybase Status |
|---|---|
| active | active |
| inactive | archived |
| sold_out | active |
| draft | draft |
| expired | active |
Note: Product statuses are not automatically updated on subsequent pulls from Etsy. This is because products in Craftybase can be linked to multiple sales channels, and updating statuses automatically could overwrite data or cause conflicts.
You can manually change a product’s status anytime from the product edit page or through the Bulk Update tool.
More details on the general rules we apply can be found here: How does Craftybase pull products from my integrated e-commerce integration?
It is strongly recommended that listings not be reused for different products on Etsy. Doing so breaches the Etsy TOC and will significantly impact your ability to track this product in Craftybase.
Etsy Variations
As part of pulling your listings, Craftybase will also pull your configured Etsy Listing Variation Properties and will map these against each of your Products. Combinations of these properties are used to create Craftybase Variations.
Example:
Mary sells a Handmade Dog Collar on Etsy with two variation properties:
- Size: Small, Medium, Large
- Color: Red, Green, Blue
Craftybase will create up to 9 possible variations, one for each size–color combination (e.g., Red | Small, Green | Medium, etc.).
When a customer purchases a specific variation on Etsy, Craftybase links that selection to the corresponding Product Variation automatically.
For example, if John buys a Red | Large collar, Craftybase associates that order line item with the Handmade Dog Collar - Red | Large listing
Pulling your Etsy orders
Each sale you make on Etsy will be pulled into Craftybase as an Order. The Etsy Receipt ID will be set as the Order Code for easy reference.
As part of our automatic daily data pulls, we attempt to identify any orders that have been canceled or adjusted on Etsy.
The total tax paid by the customer on the order will be recorded in the Tax summary. this value can include both marketplace facilitator tax (collected by Etsy) and any taxes collected directly by the seller.
Note: as of Oct 21, 2024 Shipping address data will no longer be importable via the Etsy API for new connections in the US, France and Germany.
Etsy Personalization Options
Craftybase ignores Etsy’s Personalization attribute when creating variation attributes, but this information is still included in the Order Line Item notes so you can view it during fulfillment.
Pulling your Etsy fees
Our Etsy importer checks for any valid and available fees in your Etsy Ledger and pulls them according to the help article here: About Imported Etsy Fees.
Please note: not all fees charged by Etsy to sellers are currently available to us via the API.
Pulling your purchases from Etsy
Purchases made through Etsy (e.g., materials or supplies you buy from other sellers) are not pulled into Craftybase.
FAQs
How does Craftybase handle different currencies on Etsy?
Craftybase automatically converts your prices when you pull Etsy information in a currency other than the one you have set as your default Craftybase currency. Conversions are calculated based on the European Central Bank's published daily conversion rate for the date the order was created.
Can I add more than one Etsy store to Craftybase?
Yes! Once your Etsy integration connection has been activated, you can add as many shops as you need to Craftybase.
Can Craftybase sync stock updates back to Etsy?
Yes! Craftybase now supports pushing stock levels back to Etsy using our Stock Push feature. Your inventory counts can be automatically updated based on your manufacturing or order activity in Craftybase — helping you avoid overselling and keep everything in sync, effortlessly.