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.


In this article:


How to connect your Etsy shop

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


How we import from Etsy

Once you have successfully created your connection, imports from Etsy will occur automatically each day at 5 a.m. 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 into Craftybase. This will minimize potential manual structuring and merging down the line.


Importing your 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 integration?


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 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 importing your listings, Craftybase will also import 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 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.


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.

EXAMPLE: 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.

Importing your Etsy orders

Each sale you make on Etsy will be imported 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 imports, 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. Please note that this amount will include both automatically remitted marketplace facilitator tax and/or taxes directly collected by the seller.


As of October 21, 2024, Etsy has made a change to their API, which means that shipping address information is no longer available for new connections with Craftybase. However, this does not affect the overall integration with Etsy—Craftybase is still fully capable of syncing orders, products, and inventory data from Etsy. 


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 can include it in your fulfillment process.

Importing your 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. 

Importing your purchases from Etsy

Purchases made via Etsy will not be imported.


Frequently Asked Questions


How does Craftybase handle different currencies in Etsy?

Craftybase automatically converts your prices when you import 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.

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