API & MCP documentation
Draft a digital gift card or prepaid reward, review it, and pay face value plus a service fee.
Demo mode returns a stub catalog and a stub checkout URL. It does not call Tremendous (including the free sandbox) or Stripe, and a stub draft is not a sent reward. Test mode uses the Tremendous sandbox. Tremendous sends the reward only after the shared billing webhook reports payment_status paid.
Connecting
- MCP endpoint
https://api.muse.telep.io/mcp/gift-send— streamable HTTP, JSON-RPC 2.0. Methods:initialize,tools/list,tools/call.- REST base
https://api.muse.telep.io/v1/gift-send- OpenAPI
https://api.muse.telep.io/v1/gift-send/openapi.json— exact request/response shapes for every REST route.- Auth
Authorization: Bearer <api-key>on every call. Calls are scoped to the key.
MCP tools
check_credentials
Validate GiftSend Tremendous credentials with a read-only product list. Does not create an order. Demo mode skips Tremendous and Stripe.
Takes no parameters.
list_reward_products
List digital gift cards, Visa/Mastercard prepaid, and charity rewards. Read-only. Demo returns a stub catalog and does not call Tremendous. Cash payouts are omitted.
| Parameter | Type | Required | Description |
|---|---|---|---|
country | string | no | Optional ISO country code, for example US |
category | string | no | Optional: merchant_card, visa_card, or charity |
send_gift
Open one Stripe checkout for a gift draft. Returns checkout_url. Does not create a Tremendous order. A second checkout for the same draft returns 409. Tremendous sends the reward only after the shared billing webhook reports payment_status paid.
| Parameter | Type | Required | Description |
|---|---|---|---|
draft_id | string | yes | — |
get_gift_status
Return status, delivery state, and redemption state for a gift.
| Parameter | Type | Required | Description |
|---|---|---|---|
gift_id | string | yes | — |
cancel_gift
Cancel a reward before redemption. Tremendous returns HTTP 422 when the reward was already redeemed, and that refusal is returned as-is. Demo mode does not call Tremendous.
| Parameter | Type | Required | Description |
|---|---|---|---|
gift_id | string | yes | — |
create_gift_draft
Draft a digital gift card, Visa/Mastercard prepaid reward, or charity reward. Returns draft_id and a quote (face value plus service fee). Does not create a Tremendous order. Demo mode uses a stub catalog and does not call Tremendous.
| Parameter | Type | Required | Description |
|---|---|---|---|
recipient | object | yes | — |
reward_id | string | yes | — |
amount_cents | integer | yes | Face value in cents. Maximum 200000 ($2,000). |
message | string | no | — |
delivery_method | string | yes | — |
list_gifts
List gift drafts created with this API key.
Takes no parameters.
Example: list tools over MCP
curl -X POST https://api.muse.telep.io/mcp/gift-send -H "Authorization: Bearer $TELEP_API_KEY" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}'REST example
Create via POST https://api.muse.telep.io/v1/gift-send/gifts:
curl -X POST https://api.muse.telep.io/v1/gift-send/gifts -H "Authorization: Bearer $TELEP_API_KEY" -H "Content-Type: application/json" -d '{"recipient":{"email":"ada@example.com","name":"Ada"},"reward_id":"OKMHM2X2OHYV","amount_cents":5000,"message":"Happy birthday","delivery_method":"EMAIL"}'Every REST route is described exactly in the OpenAPI document.
Demo status
Demo mode returns a stub catalog and a stub checkout URL. It does not call Tremendous (including the free sandbox) or Stripe, and a stub draft is not a sent reward. Test mode uses the Tremendous sandbox. Tremendous sends the reward only after the shared billing webhook reports payment_status paid.
Pricing: Face value pass-through plus a $2.99 service fee. Gift cards, Visa/Mastercard prepaid, and charity only. Customer total = reward face value + a $2.99 service fee (SERVICE_FEE_CENTS, default 299). Face value is a pass-through. Tremendous's fee on gift cards, Visa/Mastercard prepaid, and charity is $0. Demo mode does not bill.
What GiftSend does
GiftSend lets Muse draft a digital gift card or prepaid reward. You choose the recipient, amount, brand, and message, review it, and pay the face value plus a service fee through Stripe. Tremendous delivers the reward by email, text, or link.
Tools: list_reward_products, create_gift_draft, send_gift, get_gift_status, cancel_gift, list_gifts, and check_credentials. send_gift opens checkout. It does not create a Tremendous order.
Modes
demo: offline stubs. Zero HTTP to Tremendous, its sandbox, or Stripe.
test: Tremendous sandbox at https://testflight.tremendous.com/api/v2 (free, fake balance) and a Stripe test key. The shared /v1/billing/webhook places an order only when payment_status is paid.
live: production API at https://api.tremendous.com/api/v2. The fulfillment service does not boot until TREMENDOUS_PLATFORM_CLIENT_REFERENCE is set. A self-serve API key is not live-ready. Platform Client registration with Tremendous Sales is still required. This page does not claim that registration is finished.
Pricing
total = face value from the Tremendous catalog, read at draft time, plus the configured service fee. The default fee is $2.99. Gift cards, Visa/Mastercard prepaid, and charity have a $0 Tremendous fee, so a $50 card costs $50.00 at Tremendous. The balance that pays rewards is prefunded by bank ACH. GiftSend never auto-funds that balance by credit card.
Gift cards only
Launch scope is digital gift cards, Visa/Mastercard prepaid (Tremendous category visa_card), and charity. Venmo, PayPal, ACH, and bank payouts are disabled because those are cash transmission. Enabling them needs a separate counsel review. Limits: $2,000 per payout and $10,000 per recipient per day.
Cancellation
cancel_gift asks Tremendous to cancel the reward. A redeemed reward fails with HTTP 422, and GiftSend returns that refusal. The Tremendous API documents cancellation for non-expired rewards with a delivery failure. Rewards send when payment succeeds. The create-order field deliver_at can schedule a date within the next year (time-of-day is ignored); GiftSend v1 does not expose scheduling.
Tremendous
Rewards are delivered by Tremendous on the Platform Client track. GiftSend is not Tremendous. The Tremendous Corporate Client Service Agreement (https://www.tremendous.com/terms/) is incorporated into the GiftSend terms. Platform Client Terms: https://www.tremendous.com/platform-client-terms/. API introduction: https://developers.tremendous.com/docs/introduction. The reference overview URL returned 404; production and sandbox hosts were confirmed from the OpenAPI servers list.
Related
- GiftSend overview — https://muse.telep.io/connectors/gift-send
- Privacy policy
- Terms of service