Etsy integration

Connect listings, orders and tracking.

Automenax is a focused listing and fulfillment companion for sellers shipping their own original designs on Etsy. We use the official Etsy Open API to connect shops, create draft listings, align product templates, read order details, manage delivery profiles, and write tracking back to Etsy.

Connect your Etsy shop Read the privacy policy

Connection details

What the connected shop can use.

Automenax is an Etsy seller operations SaaS for POD shops. It connects seller shops, creates draft listings, keeps product templates aligned, manages order workflows, and synchronizes fulfillment updates through the Etsy Open API.

Shop workspace

Multiple seller shops can connect through secure Etsy OAuth, with each shop managed as a separate workspace.

Listing workflow

Create Etsy draft listings, keep product templates aligned, read order data for fulfillment, manage shipping profiles, and send tracking updates back to Etsy.

Data boundary

Buyer address data is available only inside order fulfillment flows and is not used for marketing, enrichment, or resale.

shops_r

Identify the connected Etsy shop, shop ID, seller workspace, and shop-level operating context.

transactions_r

Read receipts, purchased line items, selected variations, quantities, personalization notes, order status, and the buyer delivery address needed to ship physical orders.

transactions_w

Create shipment records and send carrier plus tracking code back to Etsy after fulfillment.

listings_r

Read listing structure, images, variations, inventory, taxonomy, and shipping_profile_id values for alignment checks.

listings_w

Create and update draft listing fields, images, SEO, variations, SKUs, price, inventory, and shipping profile assignment.

Pillars

Six commitments behind every API call

OAuth 2.0 + PKCE

Authorization Code flow with PKCE (S256), exact-match HTTPS redirect URI and CSRF state.

Multi-shop ready

Seller shops connect through secure OAuth and can be disconnected at any time.

Rate-limit posture

Per-endpoint caching, retry-after handling, exponential backoff and no unnecessary polling.

Order operations

Receipts, line items, delivery context and tracking updates stay connected to the seller workflow.

Accurate listing images

Product-specific mockup templates prevent tee, hoodie and sweatshirt mismatches.

Draft-only publishing

Listings are created as drafts. The seller reviews and publishes from Etsy.

Connection map

What Automenax reads and writes.

Shop identity

shops_r

Reads: Shop ID, shop name, seller context and shop-level settings needed to attach work to the correct store.
Writes: No shop profile edits from this workflow.
Used for: Keeps workspaces, listing drafts, order queues and settings tied to the right shop.

Draft listings

listings_r / listings_w

Reads: Existing draft, inactive and active listing structure used for duplicate checks and template alignment.
Writes: Draft listing fields, photos, title, description, tags, variations, SKUs, quantity, price and shipping_profile_id.
Used for: Builds product-ready Etsy drafts while leaving publishing under seller control.

Delivery profiles

listings_r / listings_w

Reads: Available delivery profile names, profile IDs and shipping_profile_id values attached to physical listings.
Writes: Origin country, destination, delivery cost, processing time and profile assignment when configured by the seller.
Used for: Keeps product drafts aligned with the seller's delivery setup.

Delivery address

transactions_r

Reads: Buyer delivery name and address fields included on the receipt for paid physical orders.
Writes: No buyer address edits.
Used for: Routes each paid order to the correct production or fulfillment workflow.

Order line items

transactions_r

Reads: Purchased listing, SKU, selected variations, quantity, personalization notes and order status.
Writes: No transaction edits except shipment records.
Used for: Matches the buyer's order to the correct product blank, mockup, print file and quantity.

Shipment tracking

transactions_w

Reads: Supported carrier names and receipt status before posting tracking.
Writes: Carrier name and tracking code on the Etsy receipt after shipment.
Used for: Keeps buyers and sellers updated from Etsy after the order ships.

Shop, listing, order, delivery address and tracking data are used only for seller operations, fulfillment, support, security and legal compliance. They are not used for marketing, enrichment or resale, and cached Etsy data is purged after disconnect or when no longer needed.

Endpoint reference

Etsy resources used by the workflow.

GET /shops/{shop_id}/receipts

transactions_r

Load paid/open orders, receipt status, buyer delivery fields, shipping status, and order metadata.

GET /shops/{shop_id}/receipts/{receipt_id}

transactions_r

Open a single order record for fulfillment, support, status review, and audit trail.

GET /shops/{shop_id}/receipts/{receipt_id}/transactions

transactions_r

Map each purchased item to the correct product blank, SKU, variation, print file, quantity, and personalization note.

POST /shops/{shop_id}/receipts/{receipt_id}/tracking

transactions_w

Attach carrier_name and tracking_code to the Etsy receipt once an order ships.

GET /shops/{shop_id}/shipping-carriers

transactions_r

Show Etsy-supported carrier names for consistent shipment updates.

GET /shops/{shop_id}/shipping-profiles

listings_r

Read available profile names and IDs so draft listings can use the seller's existing delivery setup.

POST/PATCH /shops/{shop_id}/shipping-profiles

listings_w

Create or update listing delivery profiles with origin, processing time, destination, and cost fields.

POST/PATCH /shops/{shop_id}/listings

listings_w

Create or update draft listings with photos, title, description, tags, variations, inventory, and selected delivery profile.

Data minimization

Buyer data is used only to fulfill the buyer's order.

Shop identity

We use shop identity only to connect drafts, settings, orders and fulfillment records to the correct Etsy shop.

Listing data

We use listing fields, photos, variations, tags, SKUs and inventory only to create and maintain seller-controlled drafts.

Order data

We use receipts, transactions, quantities, personalization notes and status only for fulfillment and support workflows.

Delivery address

We use buyer delivery address fields only to route paid physical orders to the correct fulfillment destination.

Delivery profiles

We use delivery profile fields only to keep draft physical listings aligned with the seller's configured delivery setup.

Tracking updates

We write carrier and tracking code back to Etsy only after a seller or production partner ships the order.

No marketing use

Shop, listing, buyer, order and delivery data are not used for advertising, enrichment or resale.

No screen scraping

Automenax uses the official Etsy Open API and does not sidestep Etsy through scraping.

Disconnect support

Sellers can revoke access from Automenax or Etsy, and cached Etsy data is purged after disconnect.

References

Etsy resources we follow

The term 'Etsy' is a trademark of Etsy, Inc. Automenax uses Etsy's API, but is not affiliated with, endorsed by, sponsored by, or certified by Etsy.