--- title: Stamped API Integration on Truto slug: stamped category: E-Commerce canonical: "https://truto.one/integrations/detail/stamped/" --- # Stamped API Integration on Truto **Category:** E-Commerce **Status:** Beta ## MCP-ready AI tools Truto exposes 26 tools for Stamped that AI agents can call directly. - **create_a_stamped_customer** — Create a Stamped customer for a shop. Returns the created customer including customerId, email, firstName, lastName, tags, addresses, and loyalty activity. Required: shop_id. - **list_all_stamped_customers** — List Stamped customers for a shop with optional filters. Returns customers with customerId, email, firstName, lastName, and loyalty activity. Required: shop_id. - **get_single_stamped_customer_by_id** — Get a Stamped customer by id. Returns the customer record with customerId, email, firstName, lastName, tags, addresses, and loyalty activity. Required: id and shop_id. - **update_a_stamped_customer_by_id** — Update a Stamped customer by id. Returns the updated customer with customerId, email, firstName, lastName, tags, addresses, and loyalty activity. Required: id and shop_id. - **delete_a_stamped_customer_by_id** — Delete a Stamped customer by id. Returns: softDelete, openapi, info, security, servers, paths, components. Required: id and shop_id. - **create_a_stamped_product** — Create a Stamped product in the specified shop. Returns the created product object including productId, title, status, vendor, tags, variants, and images. Required: shop_id and a JSON product body (title, status, vendor, customProductId, publishedScope, tags, variants, images, and more are accepted). - **list_all_stamped_products** — List and filter Stamped products in a shop by Shopify/Bigcommerce/custom product id, publishedScope, status, title, vendor, type, handle, or tags. Returns each product with productId, title, status, vendor, handle, tags, variants, and images. Required: shop_id. - **get_single_stamped_product_by_id** — Get a single Stamped product by id in a shop. Returns the full product object including productId, title, status, vendor, handle, tags, variants, and images. Required: shop_id and id (the productId generated by Stamped on product creation). - **update_a_stamped_product_by_id** — Update a Stamped product by id in a shop. Returns the updated product object including productId, title, status, vendor, tags, variants, and images. Required: shop_id, id, and a JSON product body. - **delete_a_stamped_product_by_id** — Delete a Stamped product by id in a shop. Returns a confirmation object with softDelete indicating whether the product was soft-deleted. Required: shop_id and id (the productId generated by Stamped on product creation). - **create_a_stamped_order** — Create a new order in Stamped. Returns the created order object including orderId, customerId, currency, cartStates, and tags. Required: shop_id. - **list_all_stamped_orders** — List orders for a Stamped shop (Filter Orders). Returns each order with orderId, customerId, currency, cartStates, and tags. Required: shop_id. - **get_single_stamped_order_by_id** — Get a single Stamped order by id. Returns the order object including orderId, customerId, currency, cartStates, and tags. Required: id and shop_id. - **update_a_stamped_order_by_id** — Update a Stamped order's cart state — line items, financial/fulfillment status, discounts, and shop price totals — by id. Returns the updated order including orderId, customerId, currency, cartStates, and tags. Required: shop_id, id. - **delete_a_stamped_order_by_id** — Delete a Stamped order by id (the orderId generated by Stamped on order creation). Returns: softDelete, openapi, info, security, servers, paths, components. Required: shop_id, id. - **list_all_stamped_customers_lookup** — Look up a Stamped customer in a shop by email or a matching platform or custom customer identifier. Returns the matched customer including customerId, email, firstName, lastName, tags, addresses, and activity. Required: shop_id. - **list_all_stamped_orders_lookup** — Look up a Stamped order by customOrderId, or by a matching shopifyId or bigcommerceId. Returns the order including orderId, customerId, currency, orderEntries, and cartStates. Required: shop_id. - **list_all_stamped_products_lookup** — Look up a Stamped product in a shop by its platform or custom product identifier. Returns the full product object including productId, title, status, vendor, tags, variants, and images. Required: shop_id. - **update_a_stamped_loyalty_customer_by_id** — Adjust a customer's VIP tier in Stamped Loyalty. Returns the resulting activity entry: activityId, customerId, dateCreated, rule, and activity (points debit/credit). Requires shop_id, customer_id, and tierName (exact tier name match). - **stamped_loyalty_customers_trigger** — Trigger a loyalty activity rule for a specific customer in Stamped. Returns: customerId, ruleId, activityId, pointsAdded, openapi, info, security, servers, paths, components. Requires shop_id and customer_id. - **create_a_stamped_loyalty_customer** — Manually adjust a customer's points balance in Stamped Loyalty, adding or subtracting points. Returns the resulting activity entry: activityId, customerId, dateCreated, rule, and activity (points debit/credit). Requires shop_id, customer_id, and points. - **delete_a_stamped_loyalty_customer_by_id** — Void a previously issued loyalty coupon for a customer in Stamped. Returns the reward record: rewardId, customerId, status, couponCode, value, dateCreated, and dateOfExpiry. Required: id (coupon code), shop_id, customer_id. - **list_all_stamped_loyalty_activities** — List loyalty activities recorded in a Stamped shop's points ledger. Returns: activityId, customerId, dateCreated, rule, activity. Required: shop_id. - **create_a_stamped_loyalty_activity** — Trigger a custom Stamped loyalty activity for a customer by firing a custom activity rule. Returns: customerId, ruleId, activityId, pointsAdded, openapi, info, security, servers, paths, components. Required: shop_id. Pass email to identify the customer and campaignId to identify the custom activity rule being triggered. - **list_all_stamped_loyalty_rewards** — List Stamped loyalty rewards for a shop. Returns each reward with rewardId, customerId, status, title, description, couponCode, value, dateCreated, and dateOfExpiry. Required: shop_id. - **create_a_stamped_loyalty_redemption** — Redeem a loyalty reward for a Stamped customer, debiting the points required by the reward rule (optionally pass points for variable-value rewards). Returns the activity record with its activityId, customerId, dateCreated, the redeemed reward rule, and the points activity. Required: shop_id, customer_id, reward_id. ## How it works 1. **Link your customer's Stamped account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Stamped.** The Proxy API is a 1-to-1 mapping of the Stamped API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Embed loyalty context in helpdesk workflows** — CX platforms can surface Stamped VIP tiers and points balances inside agent sidebars, and let agents grant appeasement points without leaving the ticket view. - **Sync loyalty state into CDPs and marketing tools** — Marketing automation and CDP platforms can pull points balances, VIP tiers, and loyalty activity into customer profiles to power segmentation and lifecycle campaigns. - **Power native rewards experiences in mobile and headless storefronts** — App builders and headless commerce platforms can display available Stamped rewards and let shoppers redeem points directly inside their custom checkout flows. - **Reconcile loyalty points with returns and post-purchase flows** — Returns and post-purchase platforms can update Stamped order status to claw back points on refunds, or issue bonus points when customers accept store credit. - **Reward non-transactional engagement from external apps** — Gamification, quiz, and community SaaS products can trigger Stamped loyalty campaigns to award points for actions like quiz completions, event attendance, or referrals. ## What you can build - **Customer loyalty lookup widget** — Fetch a Stamped customer by email or ID to display VIP tier, points balance, and recent loyalty activity anywhere in your product. - **In-app points adjustments** — Let internal users grant or deduct Stamped loyalty points from a customer's ledger for appeasements, promotions, or manual corrections. - **Custom loyalty activity triggers** — Fire Stamped loyalty campaigns by campaignId when users complete actions in your product, automatically awarding points tied to that rule. - **Programmatic reward redemption** — List available loyalty rewards for a customer and create redemptions on their behalf so they can spend points inside your app or checkout. - **Order ingestion for headless commerce** — Create and update Stamped orders from external storefronts or marketplaces so Stamped's loyalty engine calculates the correct points earned. - **VIP tier overrides** — Update a Stamped loyalty customer to force a tier upgrade or downgrade based on behavior tracked outside of Stamped. ## FAQs ### How does authentication to Stamped work through Truto? Your end users connect their Stamped account through Truto's managed auth flow. Truto handles credential storage and injection, so you never touch API keys or store secrets yourself. ### What Stamped objects can I read and write? You can create, read, update, and delete Stamped customers, products, and orders, as well as manage loyalty customers, activities, rewards, and redemptions. Lookup endpoints for customers, orders, and products are also supported for lookups by identifiers like email. ### Can I award points for actions that happen outside of Stamped? Yes. Use the create loyalty activity endpoint with a specific campaignId to trigger a Stamped rule that awards points, or use the loyalty customers trigger to fire predefined loyalty events. ### How do I keep points balances and VIP tiers in sync? Poll the list customers and list loyalty activities endpoints on your preferred cadence to refresh balances and tiers. You can also update loyalty customers directly to reflect off-platform changes. ### How are order refunds handled for loyalty clawback? Update the Stamped order via the update order endpoint to reflect the refunded financial status. Stamped's internal logic will then recalculate the associated loyalty ledger entries. ### Does Truto normalize Stamped data into a unified schema? Not currently. Stamped is available as a native integration with its own request and response shapes. If you need a unified e-commerce or loyalty schema across multiple providers, reach out to Truto and it can be built on request. ## Related reading - [Connect Stamped to Claude: Manage Store Catalog and VIP Rewards](https://truto.one/blog/connect-stamped-to-claude-manage-store-catalog-and-vip-rewards/) — A hands-on engineering guide to building a managed MCP server for Stamped. Learn how to connect Claude to Stamped to automate VIP rewards, sync catalogs, and manage store data. - [Connect Stamped to ChatGPT: Sync Customers, Orders, and Loyalty](https://truto.one/blog/connect-stamped-to-chatgpt-sync-customers-orders-and-loyalty/) — Learn how to connect Stamped to ChatGPT using a managed MCP server. Execute complex e-commerce workflows, manage loyalty tiers, and sync orders via AI. - [Connect Stamped to AI Agents: Automate Loyalty and Store Data](https://truto.one/blog/connect-stamped-to-ai-agents-automate-loyalty-and-store-data/) — Learn how to connect Stamped to AI agents using Truto's /tools endpoint. Build autonomous e-commerce workflows that manage loyalty tiers and orders.