# 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

- [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.
- [Order lifecycle](https://developer.ongoody.com/introduction/order-lifecycle.md)
- [Send methods](https://developer.ongoody.com/introduction/send-methods.md)
- [Developer mode](https://developer.ongoody.com/introduction/developer-mode.md): Enable Developer Mode on the Goody website to get product IDs and card IDs.
- [Ship to address](https://developer.ongoody.com/introduction/send-to-address.md): Ship products directly to an address with the Direct Send send method.
- [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: 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: Access the product catalog](https://developer.ongoody.com/commerce-api/access-the-catalog.md)
- [Commerce API: Create an order](https://developer.ongoody.com/commerce-api/create-an-order.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.
- [Commerce API: Payment](https://developer.ongoody.com/commerce-api/payment.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 Automation API](https://developer.ongoody.com/automation-api/overview.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)
- [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: Access the product catalog](https://developer.ongoody.com/automation-api/access-the-catalog.md)
- [Automation API: Zapier](https://developer.ongoody.com/automation-api/zapier.md): Create automations without code using Zapier workflows
- [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.
- [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.)
- [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.
- [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.
- [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.
- [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.
- [Order batch.created](https://developer.ongoody.com/webhooks/events/order_batch.created.md): Emitted when a order batch is created in the organization.
- [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.
- [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.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.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.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.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.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.canceled](https://developer.ongoody.com/webhooks/events/order.canceled.md): Emitted when an order has been canceled.
- [Event: order.refunded](https://developer.ongoody.com/webhooks/events/order.refunded.md): Emitted when an order has been refunded.
- [Changelog](https://developer.ongoody.com/resources/changelog.md): Updates to the Goody API and MCP server
- [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)
- [Calculate the price for an order batch](https://developer.ongoody.com/api-reference/order-batches/calculate-the-price-for-an-order-batch.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)
- [Cancel an order](https://developer.ongoody.com/api-reference/orders/cancel-an-order.md)
- [Update expiration for an order](https://developer.ongoody.com/api-reference/orders/update-expiration-for-an-order.md)
- [List all active brands](https://developer.ongoody.com/api-reference/brands/list-all-active-brands.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)
- [List all payment methods](https://developer.ongoody.com/api-reference/payment-methods/list-all-payment-methods.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 workspaces](https://developer.ongoody.com/api-reference/workspaces/list-all-workspaces.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)
- [List all order activities](https://developer.ongoody.com/api-reference/order-activities/list-all-order-activities.md)
- [Retrieve current user](https://developer.ongoody.com/api-reference/retrieve-current-user.md)
- [Error](https://developer.ongoody.com/api-reference/schemas/error.md)
- [ListMeta](https://developer.ongoody.com/api-reference/schemas/listmeta.md)
- [OrderBatch](https://developer.ongoody.com/api-reference/schemas/orderbatch.md)
- [Order](https://developer.ongoody.com/api-reference/schemas/order.md)
- [OrderBatchRecipient](https://developer.ongoody.com/api-reference/schemas/orderbatchrecipient.md)
- [Cart](https://developer.ongoody.com/api-reference/schemas/cart.md)
- [CartItem](https://developer.ongoody.com/api-reference/schemas/cartitem.md)
- [OrderBatchSendStatus](https://developer.ongoody.com/api-reference/schemas/orderbatchsendstatus.md)
- [OrderStatus](https://developer.ongoody.com/api-reference/schemas/orderstatus.md)
- [Shipment](https://developer.ongoody.com/api-reference/schemas/shipment.md)
- [Product](https://developer.ongoody.com/api-reference/schemas/product.md)
- [Brand](https://developer.ongoody.com/api-reference/schemas/brand.md)
- [ProductImage](https://developer.ongoody.com/api-reference/schemas/productimage.md)
- [ProductVariant](https://developer.ongoody.com/api-reference/schemas/productvariant.md)
- [Image](https://developer.ongoody.com/api-reference/schemas/image.md)
- [MailingAddress](https://developer.ongoody.com/api-reference/schemas/mailingaddress.md)
- [Me](https://developer.ongoody.com/api-reference/schemas/me.md)
- [Sender](https://developer.ongoody.com/api-reference/schemas/sender.md)
- [OrderBatchInput](https://developer.ongoody.com/api-reference/schemas/orderbatchinput.md)
- [CartInput](https://developer.ongoody.com/api-reference/schemas/cartinput.md)
- [CartItemInput](https://developer.ongoody.com/api-reference/schemas/cartiteminput.md)
- [OrderBatchSendMethod](https://developer.ongoody.com/api-reference/schemas/orderbatchsendmethod.md)
- [RecipientInput](https://developer.ongoody.com/api-reference/schemas/recipientinput.md)
- [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_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_workspaces_list](https://developer.ongoody.com/mcp-reference/tools/workspaces-list.md): Lists the Goody workspaces the connected user can gift from.
- [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_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_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_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_cards_list](https://developer.ongoody.com/mcp-reference/tools/cards-list.md): Lists Goody's greeting cards — the card shown with a gift.
- [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_get](https://developer.ongoody.com/mcp-reference/tools/contacts-get.md): Fetch one contact's full detail, including birthday and work anniversary.
- [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_update](https://developer.ongoody.com/mcp-reference/tools/contacts-update.md): Update an existing contact — only the fields you supply are changed.
- [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_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_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_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_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_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_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_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_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_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_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_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_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_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_pause](https://developer.ongoody.com/mcp-reference/tools/autogift-rules-pause.md): Pause an active autogift rule so no further gifts are scheduled.
- [goody_feedback_create](https://developer.ongoody.com/mcp-reference/tools/feedback-create.md): Send the user's feedback about Goody to the Goody team.

## OpenAPI Specs

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