# Goody Developers

> Build on Goody: send gifts and physical products programmatically with the Goody API, or gift in natural language from Claude and other AI assistants with the Goody MCP server.

## Docs

- [List all active brands](https://developer.ongoody.com/api-reference/brands/list-all-active-brands.md)
- [List all active cards](https://developer.ongoody.com/api-reference/cards/list-all-active-cards.md)
- [List all collections](https://developer.ongoody.com/api-reference/collections/list-all-collections.md)
- [Retrieve a collection](https://developer.ongoody.com/api-reference/collections/retrieve-a-collection.md)
- [Create a commerce user payment method](https://developer.ongoody.com/api-reference/commerce-user-payment-methods/create-a-commerce-user-payment-method.md)
- [List all order activities](https://developer.ongoody.com/api-reference/order-activities/list-all-order-activities.md)
- [Calculate the price for an order batch](https://developer.ongoody.com/api-reference/order-batches/calculate-the-price-for-an-order-batch.md)
- [Create an order batch](https://developer.ongoody.com/api-reference/order-batches/create-an-order-batch.md)
- [List all order batches](https://developer.ongoody.com/api-reference/order-batches/list-all-order-batches.md)
- [Retrieve an order batch](https://developer.ongoody.com/api-reference/order-batches/retrieve-an-order-batch.md)
- [Retrieve orders for an order batch](https://developer.ongoody.com/api-reference/order-batches/retrieve-orders-for-an-order-batch.md)
- [Retrieve recipients for an order batch](https://developer.ongoody.com/api-reference/order-batches/retrieve-recipients-for-an-order-batch.md)
- [Cancel an order](https://developer.ongoody.com/api-reference/orders/cancel-an-order.md)
- [List all orders](https://developer.ongoody.com/api-reference/orders/list-all-orders.md)
- [Retrieve an order](https://developer.ongoody.com/api-reference/orders/retrieve-an-order.md)
- [Update expiration for an order](https://developer.ongoody.com/api-reference/orders/update-expiration-for-an-order.md)
- [List all payment methods](https://developer.ongoody.com/api-reference/payment-methods/list-all-payment-methods.md)
- [List all active products](https://developer.ongoody.com/api-reference/products/list-all-active-products.md)
- [Retrieve a product](https://developer.ongoody.com/api-reference/products/retrieve-a-product.md)
- [Retrieve current user](https://developer.ongoody.com/api-reference/retrieve-current-user.md)
- [Brand](https://developer.ongoody.com/api-reference/schemas/brand.md)
- [Cart](https://developer.ongoody.com/api-reference/schemas/cart.md)
- [CartInput](https://developer.ongoody.com/api-reference/schemas/cartinput.md)
- [CartItem](https://developer.ongoody.com/api-reference/schemas/cartitem.md)
- [CartItemInput](https://developer.ongoody.com/api-reference/schemas/cartiteminput.md)
- [Error](https://developer.ongoody.com/api-reference/schemas/error.md)
- [Image](https://developer.ongoody.com/api-reference/schemas/image.md)
- [ListMeta](https://developer.ongoody.com/api-reference/schemas/listmeta.md)
- [MailingAddress](https://developer.ongoody.com/api-reference/schemas/mailingaddress.md)
- [Me](https://developer.ongoody.com/api-reference/schemas/me.md)
- [Order](https://developer.ongoody.com/api-reference/schemas/order.md)
- [OrderBatch](https://developer.ongoody.com/api-reference/schemas/orderbatch.md)
- [OrderBatchInput](https://developer.ongoody.com/api-reference/schemas/orderbatchinput.md)
- [OrderBatchRecipient](https://developer.ongoody.com/api-reference/schemas/orderbatchrecipient.md)
- [OrderBatchSendMethod](https://developer.ongoody.com/api-reference/schemas/orderbatchsendmethod.md)
- [OrderBatchSendStatus](https://developer.ongoody.com/api-reference/schemas/orderbatchsendstatus.md)
- [OrderStatus](https://developer.ongoody.com/api-reference/schemas/orderstatus.md)
- [Product](https://developer.ongoody.com/api-reference/schemas/product.md)
- [ProductImage](https://developer.ongoody.com/api-reference/schemas/productimage.md)
- [ProductVariant](https://developer.ongoody.com/api-reference/schemas/productvariant.md)
- [RecipientInput](https://developer.ongoody.com/api-reference/schemas/recipientinput.md)
- [Sender](https://developer.ongoody.com/api-reference/schemas/sender.md)
- [Shipment](https://developer.ongoody.com/api-reference/schemas/shipment.md)
- [List all workspaces](https://developer.ongoody.com/api-reference/workspaces/list-all-workspaces.md)
- [Automation API: Access the product catalog](https://developer.ongoody.com/automation-api/access-the-catalog.md)
- [Automation API: Authentication](https://developer.ongoody.com/automation-api/authentication.md)
- [Automation API: Create an order](https://developer.ongoody.com/automation-api/create-an-order.md)
- [Goody Automation API](https://developer.ongoody.com/automation-api/overview.md)
- [Automation API: Retrieve order status](https://developer.ongoody.com/automation-api/retrieve-order-status.md)
- [Automation API: Webhooks](https://developer.ongoody.com/automation-api/webhooks.md): 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.
- [Automation API: Zapier](https://developer.ongoody.com/automation-api/zapier.md): Create automations without code using Zapier workflows
- [Commerce API: Access the product catalog](https://developer.ongoody.com/commerce-api/access-the-catalog.md)
- [Commerce API: Authentication](https://developer.ongoody.com/commerce-api/authentication.md): Production and Sandbox accounts are separate, and you have different API keys for each environment for isolation.
- [Commerce API: Create an order](https://developer.ongoody.com/commerce-api/create-an-order.md)
- [Embedded Payment Form](https://developer.ongoody.com/commerce-api/embedded-payment-form.md): Embed Goody’s credit card form into your application to sell products without processing payment.
- [Goody Commerce API](https://developer.ongoody.com/commerce-api/overview.md): Sell physical products in your app without handling inventory, vendor partnerships, or logistics, and earn a revenue share on orders.
- [Commerce API: Payment](https://developer.ongoody.com/commerce-api/payment.md)
- [Commerce API: Retrieve order status](https://developer.ongoody.com/commerce-api/retrieve-order-status.md)
- [Commerce API: Webhooks](https://developer.ongoody.com/commerce-api/webhooks.md): 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.
- [Developer mode](https://developer.ongoody.com/introduction/developer-mode.md): Enable Developer Mode on the Goody website to get product IDs and card IDs.
- [Order lifecycle](https://developer.ongoody.com/introduction/order-lifecycle.md)
- [Goody for developers](https://developer.ongoody.com/introduction/overview.md): Send physical products and gifts programmatically with the Goody API, or gift directly from Claude and other AI assistants with the Goody MCP server.
- [Send methods](https://developer.ongoody.com/introduction/send-methods.md)
- [Ship to address](https://developer.ongoody.com/introduction/send-to-address.md): Ship products directly to an address with the Direct Send send method.
- [Capabilities & roadmap](https://developer.ongoody.com/mcp-reference/capabilities.md): What the Goody MCP server can do today, what it can't do yet, and what's on the roadmap.
- [Example prompts](https://developer.ongoody.com/mcp-reference/example-prompts.md): Real flows the Goody MCP server supports today, with illustrative responses.
- [Tool reference](https://developer.ongoody.com/mcp-reference/tools.md): The 28 tools the Goody MCP server exposes, grouped by area, with the permission each one requires.
- [goody_autogift_rules_activate](https://developer.ongoody.com/mcp-reference/tools/autogift-rules-activate.md): Activate a paused autogift rule so it begins scheduling future gifts.
- [goody_autogift_rules_create](https://developer.ongoody.com/mcp-reference/tools/autogift-rules-create.md): Create a paused autogift rule — clone a past gift or build one from scratch.
- [goody_autogift_rules_list](https://developer.ongoody.com/mcp-reference/tools/autogift-rules-list.md): List the autogift (recurring gift) rules in a workspace.
- [goody_autogift_rules_pause](https://developer.ongoody.com/mcp-reference/tools/autogift-rules-pause.md): Pause an active autogift rule so no further gifts are scheduled.
- [goody_autogift_rules_preview](https://developer.ongoody.com/mcp-reference/tools/autogift-rules-preview.md): Preview what a paused autogift rule will send — card, message, products, and cost — without sending.
- [goody_cards_list](https://developer.ongoody.com/mcp-reference/tools/cards-list.md): Lists Goody's greeting cards — the card shown with a gift.
- [goody_collections_list](https://developer.ongoody.com/mcp-reference/tools/collections-list.md): List a workspace's curated gift collections — and get the product_id to send one.
- [goody_contact_lists_create](https://developer.ongoody.com/mcp-reference/tools/contact-lists-create.md): Create a new contact list, optionally with an initial set of members.
- [goody_contact_lists_list](https://developer.ongoody.com/mcp-reference/tools/contact-lists-list.md): List a workspace's active contact lists, newest first.
- [goody_contacts_create](https://developer.ongoody.com/mcp-reference/tools/contacts-create.md): Add a new contact to a workspace and return the saved record.
- [goody_contacts_get](https://developer.ongoody.com/mcp-reference/tools/contacts-get.md): Fetch one contact's full detail, including birthday and work anniversary.
- [goody_contacts_search](https://developer.ongoody.com/mcp-reference/tools/contacts-search.md): Find a workspace contact by name, email, or phone — returns up to 25 matches.
- [goody_contacts_update](https://developer.ongoody.com/mcp-reference/tools/contacts-update.md): Update an existing contact — only the fields you supply are changed.
- [goody_feedback_create](https://developer.ongoody.com/mcp-reference/tools/feedback-create.md): Send the user's feedback about Goody to the Goody team.
- [goody_gift_of_choice_list](https://developer.ongoody.com/mcp-reference/tools/gift-of-choice-list.md): Lists Goody's Gifts of Choice — flex gifts where the recipient picks and the sender funds an amount.
- [goody_me_get](https://developer.ongoody.com/mcp-reference/tools/me-get.md): Returns the connected Goody account's identity plus the server's current time.
- [goody_messages_generate](https://developer.ongoody.com/mcp-reference/tools/messages-generate.md): Draft three candidate gift-card messages for the user to pick from or refine.
- [goody_order_batches_create](https://developer.ongoody.com/mcp-reference/tools/order-batches-create.md): Send a gift batch — charges the payment method and generates the gift links.
- [goody_order_batches_get](https://developer.ongoody.com/mcp-reference/tools/order-batches-get.md): Fetch full detail for a single gift batch — cart, recipients, and send timing.
- [goody_order_batches_list](https://developer.ongoody.com/mcp-reference/tools/order-batches-list.md): List previously-sent gift batches in a workspace, most recent first.
- [goody_order_batches_preview](https://developer.ongoody.com/mcp-reference/tools/order-batches-preview.md): Build a shareable preview link and price a gift before sending — nothing is charged.
- [goody_order_batches_price](https://developer.ongoody.com/mcp-reference/tools/order-batches-price.md): Quick price estimate — cart subtotal, tax, shipping, and total — before sending.
- [goody_orders_cancel](https://developer.ongoody.com/mcp-reference/tools/orders-cancel.md): Cancel a single order (one recipient's gift) before the recipient accepts it.
- [goody_orders_list](https://developer.ongoody.com/mcp-reference/tools/orders-list.md): List individual orders (one per recipient), across a workspace or within one batch.
- [goody_payment_methods_list](https://developer.ongoody.com/mcp-reference/tools/payment-methods-list.md): List the payment methods the user can charge for a gift in a workspace.
- [goody_products_get](https://developer.ongoody.com/mcp-reference/tools/products-get.md): Fetches full detail for a single product, richer than a search result.
- [goody_products_search](https://developer.ongoody.com/mcp-reference/tools/products-search.md): Search Goody's catalog by intent, budget, and filters — returns up to 5 curated matches.
- [goody_workspaces_list](https://developer.ongoody.com/mcp-reference/tools/workspaces-list.md): Lists the Goody workspaces the connected user can gift from.
- [Authentication & permissions](https://developer.ongoody.com/mcp/authentication.md): How the Goody MCP server authenticates — OAuth for interactive clients, personal tokens for scripts and automations — and what the Read, Write, and Send gifts permissions allow.
- [Connect Goody to Claude](https://developer.ongoody.com/mcp/connect.md): Add Goody to Claude as a custom connector using the server URL. (Directory listing is rolling out.)
- [Data handling & support](https://developer.ongoody.com/mcp/data-handling.md): What Goody records about MCP usage, what it never stores, and how to reach support.
- [The gifting flow](https://developer.ongoody.com/mcp/gifting-flow.md): How a gift goes from idea to sent through the Goody MCP server, and how the spend-confirmation safeguards work.
- [Goody MCP Server](https://developer.ongoody.com/mcp/overview.md): Send and manage business gifts directly from Claude and other MCP clients — discover a gift, write the card, see the price, and send, all in one conversation.
- [Changelog](https://developer.ongoody.com/resources/changelog.md): Updates to the Goody API and MCP server
- [Event: order.canceled](https://developer.ongoody.com/webhooks/events/order.canceled.md): Emitted when an order has been canceled.
- [Event: order.created](https://developer.ongoody.com/webhooks/events/order.created.md): 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`).
- [Event: order.delivered](https://developer.ongoody.com/webhooks/events/order.delivered.md): Emitted when an order has been delivered. If the order has multiple shipments, this is emitted when all shipments have been delivered.
- [Event: order.gift_accepted](https://developer.ongoody.com/webhooks/events/order.gift_accepted.md): 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`).
- [Event: order.gift_opened](https://developer.ongoody.com/webhooks/events/order.gift_opened.md): Emitted when a gift is first opened. Note that if you open the gift link yourself, you might trigger this event.
- [Event: order.refunded](https://developer.ongoody.com/webhooks/events/order.refunded.md): Emitted when an order has been refunded.
- [Event: order.shipped](https://developer.ongoody.com/webhooks/events/order.shipped.md): Emitted when the order is shipped. If there are multiple shipments, this is emitted when the first shipment for this order is in transit.
- [Event: order.thank_you_note_added](https://developer.ongoody.com/webhooks/events/order.thank_you_note_added.md): 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.
- [Event: order_batch.completed](https://developer.ongoody.com/webhooks/events/order_batch.completed.md): Emitted when an order batch is fully processed, which is when all orders are created for each recipient in the order batch.
- [Order batch.created](https://developer.ongoody.com/webhooks/events/order_batch.created.md): Emitted when a order batch is created in the organization.
- [Webhooks](https://developer.ongoody.com/webhooks/overview.md): 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.
- [Webhook security](https://developer.ongoody.com/webhooks/webhook-security.md): 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.

## OpenAPI Specs

- [goody-api-openapi](https://developer.ongoody.com/goody-api-openapi.json)