> ## Documentation Index
> Fetch the complete documentation index at: https://developer.ongoody.com/llms.txt
> Use this file to discover all available pages before exploring further.

# goody_order_batches_preview

> Build a shareable preview link and price a gift before sending — nothing is charged.

**Permission:** `Write` · **Workspace:** required (from `goody_workspaces_list`)

Builds a shareable preview link **and** prices a gift that has **not** been sent — nothing is charged, nothing is sent. This is the step that lets the user *see* the assembled gift (card, message, products) at a real URL and review the total before sending.

Lead your reply with the `preview_url`, relay the `total_price`, and only after the user confirms call [`goody_order_batches_create`](https://developer.ongoody.com/mcp-reference/tools/order-batches-create) with the same inputs.

> [!NOTE]
>
> There is no `payment_method_id` here — previewing neither charges nor needs a funding source.

## Parameters

**workspace\_id** `string` *required*

Workspace UUID — from `goody_workspaces_list`. Scopes the preview to this workspace.

**card\_id** `string` *required*

Card UUID — from [`goody_cards_list`](https://developer.ongoody.com/mcp-reference/tools/cards-list). Picking a real card means the preview shows the actual card the recipient will see.

**product\_id** `string`

A single product UUID — from [`goody_products_search`](https://developer.ongoody.com/mcp-reference/tools/products-search). Use this **or** `cart`, never both.

**quantity** `integer` (default: 1)

Quantity for `product_id`. Defaults to `1`.

**variable\_price** `integer`

Amount to fund, in cents, for a variable-amount Gift of Choice or variable gift card. Must fall within the gift's `[price_min, price_max]`. Only applies to `product_id`.

**cart** `object`

A multi-item cart — an object with an `items` array (not a bare array). Use this **or** `product_id`, never both.

**cart**

**items** `object[]` *required*

One entry per product in the gift.

**item**

**product\_id** `string` *required*

Product UUID.

**quantity** `integer` (default: 1)

Quantity of this product.

**variable\_price** `integer`

Amount in cents for a variable-amount gift, within its `[price_min, price_max]`.

**variants** `string[]`

Selected variant option IDs (e.g. size, color) for products that offer them.

**contact\_id** `string`

A single saved-contact UUID — from [`goody_contacts_search`](https://developer.ongoody.com/mcp-reference/tools/contacts-search). Use this **or** `recipients`. Optional: omit recipients entirely to preview a half-composed gift with a placeholder recipient.

**recipients** `object[]`

The people to send to. Use this **or** `contact_id`. Optional here — omit to preview before recipients are known.

**recipient**

**name** `string`

Full name — split on the **first** space (first token → first name, the rest → last name). Use this or `first_name` + `last_name`.

**first\_name** `string`

First name. Pair with `last_name`.

**last\_name** `string`

Last name.

**email** `string`

Recipient email.

**phone** `string`

Recipient phone, when sending by text.

**contact\_id** `string`

Link this recipient to an existing saved contact.

**mailing\_address** `object`

Required on every recipient when `send_method` is `direct_send`.

**mailing\_address**

**first\_name** `string`

Recipient first name for the shipping label.

**last\_name** `string`

Recipient last name for the shipping label.

**address\_1** `string` *required*

Street address.

**address\_2** `string`

Apartment, suite, etc.

**city** `string` *required*

City.

**state** `string` *required*

State or province.

**postal\_code** `string` *required*

ZIP or postal code.

**country** `string` *required*

Country.

**message** `string`

The note shown on the gift card. Use [`goody_messages_generate`](https://developer.ongoody.com/mcp-reference/tools/messages-generate) to draft one.

**from\_name** `string`

The "From" name the recipient sees. Defaults to the authenticated user.

**send\_method** `string` (default: link\_single)

How the recipient receives the gift. One of `link_single` (you share the link yourself), `email_and_link` (Goody emails each recipient their link), or `direct_send` (ships a physical product to each recipient — requires a `mailing_address` on every recipient).

## Returns

**preview\_url** `string`

A shareable URL that renders the assembled gift — card, message, and products. **Lead your reply with this** so the user can see exactly what they're sending.

**draft\_batch\_id** `string`

UUID of the draft batch the preview was built from.

**cart\_price** `object`

The cart subtotal before tax and shipping.

**total\_price** `object`

The full total — subtotal, tax, and shipping. Relay this to the user before sending.

## Example

```text 💬 Prompt theme={null}
"Show me a preview of the Cold Brew Kit for Sarah before sending."
```

```json 🔧 Tool call theme={null}
{
  "name": "goody_order_batches_preview",
  "arguments": {
    "workspace_id": "3f8a…",
    "card_id": "7c20…",
    "product_id": "0f3c…",
    "recipients": [
      { "name": "Sarah Chen", "email": "sarah@acme.com" }
    ],
    "message": "Thanks for everything this quarter, Sarah!",
    "from_name": "Jordan at Acme"
  }
}
```

```json ↩️ Result theme={null}
{
  "preview_url": "https://www.ongoody.com/preview/2f9c…",
  "draft_batch_id": "a18d…",
  "cart_price": { "subtotal": 4200, "currency": "USD" },
  "total_price": { "subtotal": 4200, "tax": 357, "shipping": 0, "total": 4557, "currency": "USD" }
}
```

> [!TIP]
>
> When the user confirms, send it with [`goody_order_batches_create`](https://developer.ongoody.com/mcp-reference/tools/order-batches-create) using the same inputs. For just a number without the link, use [`goody_order_batches_price`](https://developer.ongoody.com/mcp-reference/tools/order-batches-price); to draft the card message, use [`goody_messages_generate`](https://developer.ongoody.com/mcp-reference/tools/messages-generate).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.