Skip to main content
Permission: Read · Workspace: not required (global) Lists Goody’s Gifts of Choice — variable-amount flex gifts where the recipient picks from a curated set and the sender funds an amount. Use when the user wants to “let the recipient choose” or is unsure what to send.

Parameters

workspace_id
string
Optional. The catalog is global — pass a workspace UUID only to scope or validate against a workspace.
budget_cents
integer
Optional, in cents (e.g. 7500 for $75); must be positive. When set, each result’s suggested_variable_price echoes the fundable amount — your budget clamped to the gift’s range.

Returns

gifts_of_choice
object[]
Matching Gifts of Choice.
To send one, pass its id as product_id plus variable_price (cents, within the range) to goody_order_batches_create.

Example

"I don't know their taste — give me a $75 let-them-pick option."
{
  "name": "goody_gift_of_choice_list",
  "arguments": { "budget_cents": 7500 }
}
{
  "gifts_of_choice": [
    {
      "id": "0f3c…",
      "name": "Gift of Choice",
      "kind": "default",
      "price_min": 2000,
      "price_max": null,
      "suggested_variable_price": 7500,
      "occasions": ["Thank You", "Congratulations"]
    },
    {
      "id": "9a17…",
      "name": "Holiday Gift of Choice",
      "kind": "seasonal",
      "price_min": 5000,
      "price_max": 25000,
      "suggested_variable_price": 7500,
      "occasions": ["Happy Holidays"]
    }
  ]
}
Browse fixed-price gifts with goody_products_search, then send the chosen gift with goody_order_batches_create.