Quickstart

Ship your first listing

Generate a key, set your base URL, and send your first Structure payload in minutes.

Create an API key. Visit the dashboard to generate a key for your workspace.
Set your base URL. Use https://api.hermes.run unless you have a dedicated region.
Set marketplace defaults. Save your merchant location + policy IDs in Marketplace configurations, or include them per request.
Send a listing request. Structure keeps marketplace data consistent.

export HERMES_API_KEY=sk_...
export BASE_URL=https://api.hermes.run

# If defaults are saved, omit policy fields below.
curl -X POST $BASE_URL/v1/listings \
  -H "Authorization: Bearer $HERMES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images_source": ["https://example.com/camera.jpg"],
    "sku": "HERM-001",
    "marketplace": "EBAY_US",
    "merchant_location_key": "loc-1",
    "fulfillment_policy_id": "pol-fulfill",
    "payment_policy_id": "pol-pay",
    "return_policy_id": "pol-return",
    "overrides": {
      "condition": "new"
    }
  }'