Skip to main content
Goody logo
  • Category: ecommerce
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 13
  • Triggers: 0
  • Slug: GOODY
  • Version: 20261101_00

Tools

Slug: GOODY_CALCULATE_PRICE_FOR_ORDER_BATCHCalculate 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

object
required
Cart details (items and quantities)
array
required
List of recipients to estimate pricing for
string ("email_and_link" | "link_multiple_custom_list" | "direct_send")
required
Sending method; ‘direct_send’ requires mailing_address for each recipient

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOODY_CREATE_WEBHOOKTool 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

string
required
The URL for the webhook to call. This endpoint will receive POST requests with event payloads.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOODY_DELETE_WEBHOOKDelete a webhook endpoint by ID to stop receiving its Goody notifications. The tool returns a success message after a non-error response.

Input Parameters

string
required
Webhook endpoint ID to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOODY_LIST_ALL_ACTIVE_CARDSTool to list all active digital greeting cards. Use when you need to fetch available card options before sending.

Input Parameters

integer
Page number for pagination (starting from 1)
integer
Number of items per page for pagination (1-100)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOODY_LIST_ALL_ACTIVE_PRODUCTSList 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

integer
Page index for pagination, starting from 1
integer
Number of items per page, range 1-100
string
Filter products by shipping country, ISO country code
boolean
Limit to custom catalog only (approved partners)
boolean
Show inactive products in custom catalog (Commerce API custom catalogs only)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOODY_LIST_ALL_ORDER_BATCHESTool to list all order batches. Use when you need to paginate through your account’s order batches.

Input Parameters

integer
Page number for pagination, starting at 1
integer
Number of items per page, between 1 and 100

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOODY_LIST_ALL_ORDERSRetrieve 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

integer
Page number for pagination (must be >= 1).
integer
Number of orders to return per page (1-100).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOODY_LIST_ALL_PAYMENT_METHODSRetrieves 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOODY_LIST_ALL_WORKSPACESTool to list all workspaces. Use when you need to retrieve all workspaces associated with the account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOODY_LIST_COLLECTIONSTool 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

integer
Page number for pagination (must be >= 1)
integer
Number of collections to return per page (1-100, default: 20)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOODY_LIST_ORDER_ACTIVITIESTool 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

integer
Page number for pagination (must be >= 1).
integer
Number of order activities to return per page (1-100).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOODY_RETRIEVE_CURRENT_USERRetrieve 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOODY_RETRIEVE_PRODUCTTool to retrieve details of a specific product by its ID. Use after obtaining the product ID.

Input Parameters

string
required
Unique ID of the product
boolean
Limit to custom catalog only (approved API partners)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not