> ## Documentation Index
> Fetch the complete documentation index at: https://docs.helpgenie.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Print Orders
> Draft, edit, and email print orders for an activation pack's printable assets
Print orders let you bundle printable assets from an activation pack (QR stickers, posters, lookbooks) into an order that can be emailed directly to a print vendor. Admins may target another user's orders by passing `adminMode` with `userId`.
***
## Get or create print order
Returns the pack's existing draft print order, or creates a new one seeded with items for every printable asset already generated on the pack.
Must be `"print-orders"`
Must be `"get-or-create"`
UUID of the activation pack to build the order for.
Skip draft reuse and always insert a new order.
Admin only. Allow targeting another user's orders.
Admin only. UUID of the user whose orders to operate on.
The print order record.
Print order UUID.
Order status (e.g. `"draft"`, `"sent"`).
Line items — each has `id`, `label`, `url`, `quantity`, `notes`, and `assetType`.
Printer's email address.
Free-text instructions for the printer.
ISO 8601 timestamp when the order was sent.
ISO 8601 creation timestamp.
ISO 8601 last-updated timestamp.
```typescript Request theme={null}
const response = await ApiService.invoke({
resource: "print-orders",
action: "get-or-create",
data: {
activation_pack_id: "pack-uuid",
},
});
const order = response?.printOrder;
```
```bash cURL theme={null}
curl -X POST https://api.helpgenie.ai/v1/print-orders \
-H "Authorization: Bearer hg_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"resource": "print-orders",
"action": "get-or-create",
"data": {
"activation_pack_id": "pack-uuid"
}
}'
```
```json Response theme={null}
{
"success": true,
"data": {
"printOrder": {
"id": "order-uuid",
"status": "draft",
"items": [
{ "id": "item-1", "label": "QR Sticker", "url": "https://...", "quantity": 50, "assetType": "qr_sticker" }
],
"vendor_email": null,
"notes": null,
"sent_at": null,
"created_at": "2024-01-15T10:00:00.000Z",
"updated_at": "2024-01-15T10:00:00.000Z"
}
}
}
```
***
## Update print order
Updates a draft print order — its items array, vendor email, or notes.
Only draft orders can be updated. Sent orders are locked.
Must be `"print-orders"`
Must be `"update"`
The print order UUID.
Updated order line items. Each item: `{ id, label, url, quantity, notes, assetType }`.
Free-text instructions for the printer. Maximum 2,000 characters.
Printer's email address.
The `updated_at` timestamp of the draft being edited. Stale writes are rejected.
Required when `items` is provided. Artwork-input revision used to render the selected files.
Admin only. Allow targeting another user's orders.
Admin only. UUID of the user whose orders to operate on.
The updated print order object.
***
## Send print order
Emails the print order to a vendor with each item's asset attached, then marks the order sent.
Must be `"print-orders"`
Must be `"send"`
The print order UUID.
Printer's email address. Must be a valid address.
Instructions included in the email and saved on the order. Maximum 2,000 characters.
The `updated_at` timestamp of the draft being reviewed. Stale versions are rejected before delivery.
Admin only. Allow targeting another user's orders.
Admin only. UUID of the user whose orders to operate on.
The sent print order with updated `sent_at` timestamp.
Fails validation if the order has no items. Only `http(s)` item URLs are attached to the email.
```typescript Request theme={null}
const response = await ApiService.invoke({
resource: "print-orders",
action: "send",
id: "order-uuid",
data: {
vendorEmail: "printer@example.com",
notes: "Please use matte finish for all stickers.",
expectedUpdatedAt: "2024-01-15T10:00:00.000Z",
},
});
```
```bash cURL theme={null}
curl -X POST https://api.helpgenie.ai/v1/print-orders \
-H "Authorization: Bearer hg_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"resource": "print-orders",
"action": "send",
"id": "order-uuid",
"data": {
"vendorEmail": "printer@example.com",
"notes": "Please use matte finish for all stickers.",
"expectedUpdatedAt": "2024-01-15T10:00:00.000Z"
}
}'
```
***
## Error codes
| Code | Meaning |
| ------------------ | ------------------------------------------------ |
| `VALIDATION_ERROR` | Missing required parameter or order has no items |
| `NOT_FOUND` | Print order or activation pack not found |
| `FORBIDDEN` | Non-admin user attempted to target another user |
| `INTERNAL_ERROR` | Unexpected server error |