> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Goody

> Goody is a platform that enables users to send gifts and physical products without handling logistics, offering APIs for commerce and automation.

![Goody logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/goody.png?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=ca1452c0feb8ce38f3babebcce069544)

* **Category:** ecommerce
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 13
* **Triggers:** 0
* **Slug:** `GOODY`
* **Version:** 20261101\_00

## Tools

> [accordion] Calculate Price for Order Batch
>
> **Slug:** `GOODY_CALCULATE_PRICE_FOR_ORDER_BATCH`
>
> Calculate price estimate for an order batch before creation. Returns per-recipient cart pricing (product, shipping, processing, tax) and total batch cost. All prices are in USD cents (e.g., 100 = \$1.00). Use this to preview costs before creating an order batch.
>
> #### Input Parameters
>
> **cart** `object` *required*
>
> Cart details (items and quantities)
>
> **recipients** `array` *required*
>
> List of recipients to estimate pricing for
>
> **send\_method** `string ("email_and_link" | "link_multiple_custom_list" | "direct_send")` *required*
>
> Sending method; 'direct\_send' requires mailing\_address for each recipient
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Webhook
>
> **Slug:** `GOODY_CREATE_WEBHOOK`
>
> Tool to create a webhook endpoint to receive notifications about order events. Use when you need to set up automated notifications for order lifecycle events like creation, shipment, or delivery.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL for the webhook to call. This endpoint will receive POST requests with event payloads.
>
> **events** `array`
>
> Filter the events you want to receive webhooks for. Valid events include: 'order\_batch.created', 'order\_batch.completed', 'order.created', 'order.gift\_opened', 'order.gift\_accepted', 'order.thank\_you\_note\_added', 'order.shipped', 'order.delivered'. If not specified or null, all events will be sent to the webhook.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Webhook
>
> **Slug:** `GOODY_DELETE_WEBHOOK`
>
> Delete a webhook endpoint by ID to stop receiving its Goody notifications. The tool returns a success message after a non-error response.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Webhook endpoint ID to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List All Active Cards
>
> **Slug:** `GOODY_LIST_ALL_ACTIVE_CARDS`
>
> Tool to list all active digital greeting cards. Use when you need to fetch available card options before sending.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (starting from 1)
>
> **per\_page** `integer`
>
> Number of items per page for pagination (1-100)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List All Active Products
>
> **Slug:** `GOODY_LIST_ALL_ACTIVE_PRODUCTS`
>
> List products with pagination and country or custom-catalog filters. Products are active by default; Commerce API custom catalogs can also include inactive products when requested.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page index for pagination, starting from 1
>
> **per\_page** `integer`
>
> Number of items per page, range 1-100
>
> **country\_code** `string`
>
> Filter products by shipping country, ISO country code
>
> **use\_custom\_catalog** `boolean`
>
> Limit to custom catalog only (approved partners)
>
> **custom\_catalog\_show\_inactive** `boolean`
>
> Show inactive products in custom catalog (Commerce API custom catalogs only)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List All Order Batches
>
> **Slug:** `GOODY_LIST_ALL_ORDER_BATCHES`
>
> Tool to list all order batches. Use when you need to paginate through your account's order batches.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, starting at 1
>
> **per\_page** `integer`
>
> Number of items per page, between 1 and 100
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List All Orders
>
> **Slug:** `GOODY_LIST_ALL_ORDERS`
>
> Retrieve a paginated list of Goody orders across order batches. Order details include recipient information, cart items, amounts, status, and gift links; choose a page size from 1 to 100 orders.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (must be >= 1).
>
> **per\_page** `integer`
>
> Number of orders to return per page (1-100).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List All Payment Methods
>
> **Slug:** `GOODY_LIST_ALL_PAYMENT_METHODS`
>
> Retrieves all saved payment methods for the authenticated account. Payment methods include credit cards and other payment types that can be used when creating orders. No parameters required - simply call this action to get the complete list of payment methods with their IDs, names, and details.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List All Workspaces
>
> **Slug:** `GOODY_LIST_ALL_WORKSPACES`
>
> Tool to list all workspaces. Use when you need to retrieve all workspaces associated with the account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Collections
>
> **Slug:** `GOODY_LIST_COLLECTIONS`
>
> Tool to list all collections across accessible workspaces. Use when you need to retrieve product collections available in Goody. This endpoint is limited to Automation API usage and returns paginated results.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (must be >= 1)
>
> **per\_page** `integer`
>
> Number of collections to return per page (1-100, default: 20)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Order Activities
>
> **Slug:** `GOODY_LIST_ORDER_ACTIVITIES`
>
> Tool to list all order activities (events) in your workspace. Returns a paginated list of order status transitions and related events. Use when you need to track order lifecycle events, monitor status changes, or audit order history.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (must be >= 1).
>
> **per\_page** `integer`
>
> Number of order activities to return per page (1-100).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve Current User
>
> **Slug:** `GOODY_RETRIEVE_CURRENT_USER`
>
> Retrieve the authenticated account's identity from the Goody API to verify authentication. Depending on the API credential, the response may contain an email or a public app ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve Product
>
> **Slug:** `GOODY_RETRIEVE_PRODUCT`
>
> Tool to retrieve details of a specific product by its ID. Use after obtaining the product ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique ID of the product
>
> **use\_custom\_catalog** `boolean`
>
> Limit to custom catalog only (approved API partners)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
