# How To Give Hermes Access To Etsy + Printify

## Safest recommended setup

Use API/token access where possible. Do **not** paste your Etsy or Printify password into chat.

There are two access levels:

1. **Printify API token** — lets Hermes create/manage Printify products and publish them to your connected Etsy store through Printify.
2. **Etsy browser/API access** — needed for direct Etsy shop management, stats, messages, listing edits outside Printify, and deeper automation.

Because Printify is already connected to Etsy, start with Printify API access first. That is the fastest path.

---

## Option A — Fastest: Printify API token

### Step 1: Create Printify personal access token

1. Log in to Printify.
2. Open account/settings area.
3. Go to API / Developer / Personal access tokens.
4. Create a new token named: `Hermes Etsy Product Factory`.
5. Give it scopes/permissions for:
   - Shops read
   - Products read/write
   - Uploads read/write
   - Orders read if available
   - Publishing products if scope is shown
6. Copy the token once.

### Step 2: Send/store token securely

Preferred: place it on the machine, not in public chat.

Create or edit this file:

`/root/.hermes/.env`

Add:

```bash
PRINTIFY_API_TOKEN=your_token_here
```

Then tell Hermes: `I added the Printify token.`

If you cannot edit files, paste only through a secure/private channel and rotate the token later.

### Step 3: Hermes verifies Printify access

Hermes will run:

```bash
curl -s -H "Authorization: Bearer $PRINTIFY_API_TOKEN" https://api.printify.com/v1/shops.json
```

Expected result: your connected shop appears, including a Printify `shop_id`.

### Step 4: Hermes saves shop ID

After verification, Hermes stores:

```bash
PRINTIFY_SHOP_ID=your_shop_id_here
```

Then it can start creating draft products in Printify.

---

## Option B — Etsy access for shop/stats/manual publishing work

### Safest method: live logged-in browser session

1. Open Etsy in the browser session Hermes can control.
2. You personally log in and complete 2FA.
3. Do not give Hermes your password.
4. Once logged in, say: `Etsy is logged in; continue.`

Hermes can then use browser automation to work inside the account.

### Better long-term method: Etsy developer/API app

1. Go to Etsy Developers.
2. Create an app for Aetheris/Hermes automation.
3. Generate API key/client ID.
4. Complete OAuth authorization for your shop.
5. Store credentials in `/root/.hermes/.env`:

```bash
ETSY_CLIENT_ID=...
ETSY_CLIENT_SECRET=...
ETSY_ACCESS_TOKEN=...
ETSY_REFRESH_TOKEN=...
ETSY_SHOP_ID=...
```

This is more setup, but better for autonomous stats/listing sync later.

---

## Option C — Temporary account/team access

If Etsy/Printify support adding team/staff users on your plan/account, create a dedicated user for automation:

Email/name: `Hermes / Aetheris Automation`

Permissions needed:

- Manage listings/products
- View shop stats
- Manage orders only if you want fulfillment/order checks
- Avoid payout/billing/admin permissions unless required

Use least privilege. Revoke access anytime.

---

## Security rules

- Do not paste your main passwords into chat.
- Use API tokens or logged-in sessions instead.
- Use a dedicated token named clearly for Hermes.
- Revoke/rotate if anything feels wrong.
- Start with draft product creation, then approve first live publish.

---

## What Hermes can do once access works

With Printify token:

- List connected Printify/Etsy stores.
- Upload generated designs.
- Create Printify products.
- Generate mockups.
- Publish products to the connected Etsy store through Printify.
- Read product/order data if scopes allow.

With Etsy access:

- Edit Etsy listing SEO.
- Check stats/favorites/views.
- Improve listings based on data.
- Manage shop sections and listing presentation.
- Potentially create Etsy-native digital listings, depending on API/session access.

---

## First command after you add the token

Tell Hermes:

`Printify token is in /root/.hermes/.env. Verify access and list my shops.`

Then Hermes will verify and continue.