---
title: "Send shipping update emails to multiple orders"
description: "Send shipping update emails to multiple preorders. You can specify orders using either: - STOQ internal order IDs (UUIDs) via order_ids - Shopify order IDs via shopify_order_ids You must provide one or the other, but not"
url: https://docs.stoqapp.com/v1/preorders/send-shipping-update-emails-to-multiple-orders/
api: "API v1 (legacy)"
method: POST
path: "/external/preorders/send_shipping_update"
---

# Send shipping update emails to multiple orders

`POST https://app.stoqapp.com/api/v1/external/preorders/send_shipping_update`

Send shipping update emails to multiple preorders. You can specify orders using either:

- STOQ internal order IDs (UUIDs) via `order_ids`
- Shopify order IDs via `shopify_order_ids`

You must provide one or the other, but not both.

## Headers

- `X-Auth-Token` (string, required): API key for authentication

## Request body

- `order_ids` (array of strings): Array of STOQ internal order UUIDs to send shipping updates to (mutually exclusive with shopify_order_ids)
- `shopify_order_ids` (array of integers): Array of Shopify order IDs to send shipping updates to (mutually exclusive with order_ids)
- `subject` (string, required): Email subject line
- `header` (string, required): Email header text
- `description` (string, required): Email body description

## Returns

- `success` (boolean): e.g. `true`
- `message` (string): e.g. `Shipping updates queued`
- `orders_count` (integer): Number of orders that will receive the shipping update

Rate limit: this call costs 2 points ([rate limits](https://docs.stoqapp.com/docs/rate-limits/)).

## Example request

```sh
curl -X POST "https://app.stoqapp.com/api/v1/external/preorders/send_shipping_update" \
  -H "X-Auth-Token: $STOQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "shopify_order_ids": [
      5012345678901,
      5012345678902
    ],
    "subject": "Your preorder has shipped",
    "header": "Good news!",
    "description": "Your Summer Preorder items are on the way and should arrive within 5–7 business days."
  }'
```

## 200

Shipping update emails queued successfully

```json
{
  "success": true,
  "message": "Shipping updates queued",
  "orders_count": 2
}
```

## 400

Bad request - missing required parameters or invalid input

## 401

Unauthorized

## 404

No valid orders found