API Reference

Goody

Commerce API Keys

Automation API Keys

List all active products

An array of brand values for this brand. Potential values are USA Made, Social Impact Driven, Sustainable, Gluten Free, Vegan, Kosher Certified, Female Founded, AAPI Founded, BIPOC Founded, Black Founded, LGBTQ+ Founded, and Hispanic Founded.

Whether this brand is excluded from the commerce revenue share. Only displayed on the products endpoint when using a commerce app.

When set and when the product price is above this amount, shipping is free. In cents. Products in a cart for this brand can combine to reach this threshold.

The price of shipping for this brand, in cents.

An array of attributes that describe this product.

Whether the price of this product is variable. If true, then the price can be set by the sender.

The maximum price of the product, in cents. Only used if price_is_variable is true.

The minimum price of the product, in cents. Only used if price_is_variable is true.

An optional description of this product with custom verbiage for recipients. When provided, it overrides the subtitle for the product when displayed to the recipient. Falls back to the subtitle.

For approved API partners only. A custom price tier for this product.

The US states that this product cannot be shipped to.

Whether this product is active. Since the product catalog only returns active products by default, this is always `true`, except if you are a Commerce API customer using a custom catalog, and are pulling products with the `custom_catalog_show_inactive` flag.

An optional one-line description of this product. When provided, it overrides the subtitle when displayed in areas with less space. Not always provided.

The date and time this product was last updated, ISO 8601 format. This is bumped when the product, brand, product variants, product attributes, or product images are updated.

For products that have multiple types of variants, such as both Color and Size, this array contains each group and the options for each group. All variant group permutations have a variant generated for them, constructed from the options in the order of the groups, separated by ` / `, e.g. `Medium / Black` when the groups are Size and Color.

The label for the variants of this product, e.g. "Size" or "Color".

The number of variants that can be selected for this product. For example, if this is a t-shirt, then this would be 1, since you can only select one size. If this were a build-a-box of chocolates, this could be 3 if you could select 3 flavor variants.

The content for this attribute, e.g. "80% cotton, 20% elastane". This can be text or sanitized HTML (you might choose to sanitize the HTML as well). Allowed elements are a (href allowed), div, img (src, width height, alt allowed), span, p, br, strong, b, em, i, ol, ul, li, and hr.

The label for this attribute, e.g. "Materials".

The name of the variant group, e.g. "Size" or "Color".

The hex color code for this option, e.g. "#000000", if any.

The name of the variant group option, e.g. "Small" for the "Size" variant group.

bearer

Goody's API lets you send physical products and gifts programmatically.

Overview

Goody API

Order lifecycle

Send methods

Enable Developer Mode on the Goody website to get product IDs and card IDs.

Developer mode

Ship products directly to an address with the Direct Send send method.

Ship to address

Sell physical products in your app without handling inventory, vendor partnerships, or logistics, and earn a revenue share on orders.

Goody Commerce API

Production and Sandbox accounts are separate, and you have different API keys for each environment for isolation.

Authentication

Commerce API: Authentication

Access the catalog

Commerce API: Access the product catalog

Create an order

Commerce API: Create an order

Retrieve order status

Commerce API: Retrieve order status

Webhooks allow you to be notified when events happen on Goody orders and order batches. You can subscribe to all webhooks, or a subset of them. Webhooks are sent by the Svix platform.

Webhooks

Commerce API: Webhooks

Payment

Commerce API: Payment

Goody Automation API

Automation API: Authentication

Automation API: Create an order

Automation API: Retrieve order status

Automation API: Webhooks

Automation API: Access the product catalog

Create automations without code using Zapier workflows

Zapier

Automation API: Zapier

Webhook Setup

To ensure the integrity of the webhooks you receive, we recommend verifying the signatures of the webhooks you receive. The webhook platform we use, Svix, provides packages for multiple languages that make verifying signatures easy.

Security

Webhook security

Event: order_batch.created

Emitted when a order batch is created in the organization.

order_batch.created

Emitted when an order batch is fully processed, which is when all orders are created for each recipient in the order batch.

order_batch.completed

Event: order_batch.completed

Emitted when an order has been created and is ready to be opened and accepted (if it's a gift). An individual gift link is available (`individual_gift_link`).

order.created

Event: order.created

Emitted when a gift is first opened. Note that if you open the gift link yourself, you might trigger this event.

order.gift_opened

Event: order.gift_opened

Emitted when a gift has been accepted by a recipient, and the final costs of the order have been calculated. You can also view whether they swapped the gift (`is_swapped`) and what they swapped to (`cart`).

order.gift_accepted

Event: order.gift_accepted

Emitted when the recipient adds a thank you note to a gift. This typically happens shortly after the gift has been accepted, but can happen anytime after acceptance. You can access the thank you note on the `thank_you_note` property of the order.

order.thank_you_note_added

Event: order.thank_you_note_added

Emitted when the order is shipped. If there are multiple shipments, this is emitted when the first shipment for this order is in transit.

order.shipped

Event: order.shipped

Emitted when an order has been delivered. If the order has multiple shipments, this is emitted when all shipments have been delivered.

Order Batches

Orders

Products

Payment Methods

Workspaces

Cards

Me

Schemas

List all active products

Authorizations

Query Parameters

Response