> ## 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_create

> Send a gift batch — charges the payment method and generates the gift links.

**Permission:** `Send gifts` · **Workspace:** required (from `goody_workspaces_list`)

Sends a gift batch — charges the payment method and generates the gift links.

> [!WARNING]
>
> This spends real money and cannot be undone from here. Preview or price first, relay the total, and only call this **after** the user confirms both the price and the recipients.

## Parameters

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

Workspace UUID — from `goody_workspaces_list`. Charges and sends from this workspace.

**payment\_method\_id** `string` *required*

The funding source — from [`goody_payment_methods_list`](https://developer.ongoody.com/mcp-reference/tools/payment-methods-list). A saved-card UUID, or the literal `BALANCE`, `WORKSPACE_BALANCE`, or `CORPORATE_ACCOUNT` sentinel.

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

Card UUID — from [`goody_cards_list`](https://developer.ongoody.com/mcp-reference/tools/cards-list). The card the recipient sees with the gift.

**confirmed** `boolean` *required*

Must be the literal `true` — the tool rejects anything else. Pass `true` only after the user has approved the price and recipients.

**send\_method** `string` *required*

How each recipient receives the gift. **No default — you must choose one:**

* `link_single` — the recipient is **not** auto-notified; you share the link yourself.
* `email_and_link` — Goody emails each recipient their gift link.
* `direct_send` — Goody ships the physical product to each recipient's `mailing_address`, with no email. The `contact_id` shorthand can't be combined with `direct_send`.

**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`. Cannot be combined with `direct_send`.

**recipients** `object[]`

The people to send to. Use this **or** `contact_id`.

**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.

**swap** `string` (default: single)

Whether the recipient may swap the gift. One of `single` (swap once), `multiple` (swap freely), or `disabled` (no swapping).

**scheduled\_send\_on** `string`

ISO 8601 datetime to delay sending. Must be in the future and at most 3 months out — anchor "now" to [`goody_me_get`](https://developer.ongoody.com/mcp-reference/tools/me-get)'s `server_time`.

**expires\_at** `string`

ISO 8601 datetime the gift expires if the recipient hasn't accepted it. **Required when paying from `BALANCE`.** The standard default is about 10 weeks. Mutually exclusive with `expires_on`.

**expires\_on** `string`

Date alias `YYYY-MM-DD`, coerced to end of day. Mutually exclusive with `expires_at`.

**alcohol\_age\_verification\_attested** `boolean`

Must be `true` when the cart contains alcohol.

**international\_shipping\_tier** `string` (default: disabled)

How far the gift can ship. One of `disabled` (default; US & Canada only), `standard`, or `full` (global, 140+ countries; up to about \$55/order in taxes, tariffs, and freight).

**international\_gift\_cards\_enabled** `boolean`

Lets recipients outside supported regions swap their gift for a gift card.

**custom\_form\_id** `string`

Attach an existing custom form's recipient questions to the gift.

> [!NOTE]
>
> **Alcohol gifts** require the account to be alcohol-enabled, cannot be paid from `BALANCE`, and require `alcohol_age_verification_attested: true`.

## Returns

**order\_batch** `object`

The created batch.

**order\_batch**

**id** `string`

Batch UUID — pass as `order_batch_id` to [`goody_order_batches_get`](https://developer.ongoody.com/mcp-reference/tools/order-batches-get) or [`goody_orders_list`](https://developer.ongoody.com/mcp-reference/tools/orders-list).

**public\_id** `string`

The batch's public identifier.

**status** `string`

Where the batch is in its lifecycle.

**preview\_url** `string | null`

A shareable URL that renders the sent gift. **Lead your reply with this.**

**sender\_preview\_urls** `string[]`

Per-recipient sender-view links.

**payment\_method** `object | null`

The funding source that was charged.

**payment\_method**

**id** `string`

The payment-method UUID, or the `BALANCE` / `WORKSPACE_BALANCE` / `CORPORATE_ACCOUNT` sentinel.

**name** `string`

Display name, e.g. "Visa 1234".

**notification\_summary** `string | null`

Whether and how recipients were notified. State this to the user.

**suggested\_next\_steps** `string[]`

Follow-on actions you can offer the user.

## Example

```text 💬 Prompt theme={null}
"Yes, send it."
```

```json 🔧 Tool call theme={null}
{
  "name": "goody_order_batches_create",
  "arguments": {
    "workspace_id": "3f8a…",
    "confirmed": true,
    "card_id": "7c20…",
    "payment_method_id": "c41d…",
    "product_id": "0f3c…",
    "contact_id": "5b6e…",
    "send_method": "email_and_link",
    "message": "Thanks for everything this quarter, Sarah!",
    "from_name": "Jordan at Acme"
  }
}
```

```json ↩️ Result theme={null}
{
  "order_batch": {
    "id": "b92e…",
    "public_id": "gift_2f9c…",
    "status": "sent"
  },
  "preview_url": "https://www.ongoody.com/preview/2f9c…",
  "sender_preview_urls": ["https://www.ongoody.com/s/8d41…"],
  "payment_method": { "id": "c41d…", "name": "Visa 1234" },
  "notification_summary": "Goody emailed Sarah Chen a link to claim her gift.",
  "suggested_next_steps": [
    "Track whether Sarah opens her gift with goody_orders_list.",
    "Set this up to recur for future occasions with goody_autogift_rules_create."
  ]
}
```

> [!TIP]
>
> Build the confirmation step with [`goody_order_batches_preview`](https://developer.ongoody.com/mcp-reference/tools/order-batches-preview) before calling this. To make a one-off gift recurring, offer [`goody_autogift_rules_create`](https://developer.ongoody.com/mcp-reference/tools/autogift-rules-create).


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