# Buy from Macy's via API

Automate purchasing from Macy's department store. Buy fashion, home, and beauty products programmatically through Zinc.

[View API docs](/content/docs/index.html) [Start building](https://app.zinc.com/)

## How the Macy's integration works

Macy's is one of America's most iconic department stores, offering a wide selection of fashion, beauty, home goods, and accessories from hundreds of brands. Zinc's Macy's integration enables programmatic access to their full online catalog.

Great for gifting platforms, corporate rewards programs, and multi-retailer applications that need access to a broad range of mid-to-premium brands across multiple product categories.

Retailer: macys.com](https://macys.com/) | US Rank:#21 | Free Shipping:$49+

## What you can build with the Macy's API

Build with the Macy's integration API for search, ordering, tracking, and returns.

### Macy's Order Placement API

Place orders with a product URL and shipping address. No checkout flows required — Zinc handles the retailer-side workflow and processes orders asynchronously.

POST/orders

```
{
  "products": [
    {
      "url": "https://macys.com/...",
      "quantity": 1
    }
  ],
  "shipping_address": {
    "first_name": "Jane",
    "last_name": "Doe",
    "address_line1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105",
    "country": "US",
    "phone_number": "5551234567"
  },
  "max_price": 39900
}
```

### Macy's Order Status API

Retrieve order details including item statuses, shipping address, and processing results. Poll to track progress from pending through to delivery.

GET/orders/{order_id}

```
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "order_placed",
  "max_price": 39900,
  "items": [
    {
      "url": "https://macys.com/...",
      "quantity": 1,
      "status": "shipped"
    }
  ],
  "tracking_numbers": [
    {
      "carrier": "ups",
      "tracking_number": "1Z999AA10123456784",
      "created_at": "2026-01-15T14:30:00Z"
    }
  ],
  "created_at": "2026-01-15T10:00:00Z"
}
```

### Macy's Shipment Tracking

Tracking numbers are automatically extracted from retailer shipping notifications and returned in the order response. Supports UPS, FedEx, USPS, Amazon Logistics, and DHL.

GET/orders/{order_id}

```
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "order_placed",
  "tracking_numbers": [
    {
      "carrier": "ups",
      "tracking_number": "1Z999AA10123456784",
      "created_at": "2026-01-15T14:30:00Z"
    },
    {
      "carrier": "amazon",
      "tracking_number": "TBA123456789000",
      "created_at": "2026-01-16T09:15:00Z"
    }
  ]
}
```

### Macy's Managed Accounts

Use Zinc-managed checkout accounts or bring your own retailer credentials. Managed accounts handle login, 2FA, and payment automatically — no account setup required.

GET/managed-accounts

```
{
  "credentials": [
    {
      "short_id": "zn_acct_a1b2c3d4",
      "email": "orders@example.com",
      "retailer": "macys",
      "has_totp": true,
      "has_forwarding": true
    }
  ],
  "total": 1
}
```

## Macy's Integration FAQ

### What can I do with the Macy's API integration?

You can search products, place orders, track shipments, and handle returns through a single Zinc API integration for Macy's.

### Do I need to build a checkout flow for Macy's?

No. Zinc handles the retailer-side ordering workflow so your app can place orders directly via API calls.

### What is the free shipping minimum for Macy's?

Macy's offers free standard shipping on orders of **$49 or more** before tax. Lower minimums for Star Rewards members. Orders below the minimum will incur a shipping fee. Note that shipping policies can change, so check Macy's's website for the most current thresholds.

### Can I get shipment tracking updates for Macy's orders?

Yes. You can fetch tracking status through the API and subscribe to webhook events for shipping and delivery updates.

### How do I start using the Macy's integration API?

[Create an account](https://app.zinc.com/), get your API key, and follow the [Zinc API docs](/content/docs/index.html) to send your first search or order request.