Goody API

Name: Goody API
Brand: Goody API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentE CommerceOrder Managementbearer9 EndpointsREST

For Agents

Send personalised gifts at scale by creating orders or batches, browsing the Goody product catalog, and managing recipients through 9 endpoints.

Install Jentic One Beta

Connect the Goody API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Goody API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgoody.com%2Fgoody" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgoody.com%2Fgoody" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Goody API.

Create a gift order for one recipient with a chosen Goody product

Send a batch order to many recipients in one API call

Cancel an order before it has been redeemed by the recipient

List Goody products and read full product details before sending

GET STARTED

Start building with Goody API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Goody API for, with concrete tasks.

★ Sales Prospect Gifting

Sales teams trigger personalised gifts after discovery calls or stage changes. POST /orders creates a single-recipient order with a chosen product and message, and Goody handles redemption - recipients pick a swap if the gift does not suit them, which avoids delivery friction.

Create a gift order for prod_coffee_sampler to prospect@example.com after the deal stage moves to 'Discovery Complete'.

Customer Retention Batch Gifting

Customer success teams send a single batch gift order to dozens or hundreds of customers around renewals, milestones, or apologies. POST /batches accepts the recipient list and one product so finance gets one charge and ops gets one job to monitor.

Create a batch gift order with prod_curated_box for the 200 enterprise customers whose renewal is in 90 days.

Recruiting Welcome Gifts

People teams send welcome gifts to new hires on their start date by automating POST /orders from the HR system. Goody schedules delivery so the gift lands when the new hire is most likely to share it, which boosts day-one sentiment.

On a new hire's start date, create a Goody order with prod_welcome_kit to their personal email.

AI Agent Gifting Step via Jentic

An AI agent that handles customer follow-up adds personalised gifting as a step by calling Goody through Jentic. The agent searches for the right operation, loads the order schema, and executes with the bearer token held in the vault - no manual REST plumbing or product-ID hunting in the docs.

When a CSAT score of 9+ comes in, search Goody for products under $40, pick one, and send the gift to the customer.

Key Endpoints

9 endpoints — jentic publishes the only available openapi specification for goody api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/orders

List orders

POST

/orders

Create an order

GET

/orders/{orderId}

Get an order

PATCH

/orders/{orderId}

Update an order

POST

/orders/{orderId}/cancel

Cancel an order

GET

/products

List products

POST

/batches

Create a batch order

GET

/orders

List orders

POST

/orders

Create an order

GET

/orders/{orderId}

Get an order

PATCH

/orders/{orderId}

Update an order

POST

/orders/{orderId}/cancel

Cancel an order

GET

/products

List products

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring Goody by hand means implementing its bearer auth against api.ongoody.com, scoping calls to a single workspace, and mapping the single and batch gift-order endpoints yourself. Through Jentic you install once, import Goody from the API Directory, store the token once, and your agent calls it.

Permission scoping

Goody creates orders through a top-level POST body and scopes the token to one workspace, so scope the agent to the operations it needs, such as placing an order or browsing products. You choose the operations it may call, so ones like cancelling an order are not included unless you add them.

Credential isolation

Your Goody token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'send a goody gift to a customer' or 'browse the gift catalog', and Jentic returns the matching Goody operation with its input schema so the agent calls the right endpoint without reading the reference.

FAQs

Specific to using Goody API through Jentic.

Why is there no official OpenAPI spec for Goody API?

Goody does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Goody API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the Goody API use?

Goody uses bearer token authentication on the Authorization header. Tokens are issued from the Goody dashboard and scoped to one workspace. Through Jentic the token is held in the encrypted vault and never enters the agent's context.

Can I send gifts to many recipients in one call?

Yes. POST /batches accepts a list of recipients and a single product so finance is charged once and you only need to monitor one batch ID. POST /orders is the right choice when each recipient gets a different product or message.

What are the rate limits for the Goody API?

Goody applies per-workspace rate limits documented at ongoody.com/help. The OpenAPI spec does not encode exact numbers, so check Goody support before running batch sends to thousands of recipients - for those, POST /batches is preferable to a loop of POST /orders.

How do I send a personalised gift through Jentic?

Search Jentic for 'send a goody gift', load the schema for POST /orders, and execute with the recipient and product ID. Jentic injects the bearer token at execution so the agent only handles the gift contents and recipient details.

Can I cancel a gift after sending it?

Yes, until the recipient redeems it. POST /orders/{orderId}/cancel cancels an unredeemed order and refunds the workspace, but once the recipient has accepted the gift the cancellation will fail and the order is final.

Can I limit what my agent is allowed to do with the Goody API?

Yes. Because Jentic One is self-hosted, your own rules decide which Goody operations and credentials the agent may use, and the bearer token stays scoped to a single workspace. You can allow just the operations the agent needs, such as creating an order through POST /orders or browsing the catalog with GET /products, while leaving out others like cancelling an order via POST /orders/{orderId}/cancel unless you add them. The agent can only call the endpoints you have granted it.

Goody API

Connect the Goody API to your agent

Capabilities

Start building with Goody API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs