Connect Etsy to Craftybase

Learn how Craftybase imports your Etsy data.

This article will guide you through how to connect to Etsy, and what types of data we can import 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 import your products and orders into Craftybase so that you can be sure that your inventory levels are always automatically factoring in sales from this source.


Connect to Etsy

To connect your Etsy store to Craftybase, follow the directions in our help article: Connect your Etsy Shop »

Once you have your connection successfully created, imports from Etsy will occur automatically each day, at 5 am in your local time zone. You can also run a manual import, if required, between the daily scheduled imports.

Your first import will, by default, attempt to download all data from your Account Start Date.

Note: Regardless of the date range selected, Craftybase will import 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. 

It is recommended that you always create your products on Etsy where possible and then import them to create as products in Craftybase. This means that your external references will be correct from the start and you will not need to do any merging between your manually created products and imported ones.


Etsy Listings

Listings from Etsy will be imported as both Products and Listings in Craftybase. More details on the rules we apply can be found here: How does Craftybase import products from my integrated e-commerce sales channels?

All listings from Etsy will be imported as Active unless they are set as Removed in Etsy, in which case they will be marked as Archived.

It is strongly recommended that listings are not reused for different products on Etsy. This is a breach of the Etsy TOC and will have a significant impact on your ability to track this product in Craftybase.


Etsy Orders

Each Etsy Sale is imported as a Craftybase Order

The Etsy Receipt ID is set as the Order Code for reference.

As part of our automatic daily imports, we attempt to identify any orders that have been canceled or adjusted on Etsy. This article explains more about how Craftybase handles canceled orders: About Etsy canceled orders.

Craftybase automatically converts your prices when you import Etsy information in a different currency to the one you have set as your default Craftybase currency. Conversions are calculated based on the European Central Bank published daily conversion rate. for the date the order was created.

Total tax paid by the customer for the order will be recorded in the Tax summary for the order. Please note that this amount will include both automatically remitted marketplace facilitator tax and/or taxes directly collected by the seller.

Etsy Personalization Options

Craftybase will ignore the Etsy Personalization attribute when creating new variation attributes and variations. We will, however, include this information in the Order Line Item notes so you are able to include this information in your fulfillment process.


Etsy Fees

Our Etsy importer checks for any valid and available fees in your Etsy Ledger and imports 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. 


Etsy Purchases

Purchases made via Etsy will not be imported.


Etsy Variations

As part of the Etsy import process, Craftybase imports your configured Etsy Listing Variation Properties and stores these against each of your Products.


Mary has two listing variation properties called “Size” and “Color” for the listing called “Handmade Dog Collar”. For the “Size” property, there are three options configured: Small, Medium and Large. For the “Color” property, there are also three options: Red, Green and Blue.

Combinations of these properties are used to create Craftybase Variations.


In Craftybase, there would potentially be 3 × 3 Variations created for this product to represent every combination that can possibly be sold:

Red | Small

Red | Medium

Red | Large

Green | Small

Green | Medium

Green | Large

Blue | Small

Blue | Medium

Blue | Large


Whenever you sell a Listing with configured variation properties on Etsy, the variation selected by the customer is linked to your Order Line Item in Craftybase via the Craftybase Variation.


John purchases the Red Large variation of the “Handmade Dog Collar”. In Craftybase, the “Red | Large” variation for the product is created, and the order line item is associated with both the “Handmade Dog Collar” product and the “Red | Large” Variation.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.