E-Commerce · Beta
Stamped
API integration
Ship E-Commerce features without building the integration. Full Stamped API access via Proxy and 20+ MCP-ready tools for AI agents — extend models and mappings to fit your product.
Built for specific customer use cases. Issues are resolved quickly.
Talk to usUse Cases
Why integrate with Stamped
Common scenarios for SaaS companies building Stamped integrations for their customers.
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
Ship these features with Truto + Stamped
Concrete product features your team can ship faster by leveraging Truto’s Stamped integration instead of building from scratch.
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.
SuperAI
Stamped AI agent tools
Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.
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.
Why Truto
Why use Truto’s MCP server for Stamped
Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 800+ integrations.
Auto-generated, always up to date
Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.
Fine-grained access control
Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.
Multi-tenant by design
Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.
Works with every MCP client
Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.
Built-in auth, rate limits, and error handling
Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.
Expiring and auditable servers
Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.
How It Works
From zero to integrated
Go live with Stamped in under an hour. No boilerplate, no maintenance burden.
Link your customer’s Stamped account
Use Truto’s frontend SDK to connect your customer’s Stamped account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.
We handle authentication
Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.
Call our API, we call Stamped
Truto’s Proxy API is a 1-to-1 mapping of the Stamped API. You call us, we call Stamped, and pass the response back in the same cycle.
Unified response format
Every response follows a single format across all integrations. We translate Stamped’s pagination into unified cursor-based pagination. Data is always in the result attribute.
FAQs
Common questions about Stamped on Truto
Authentication, rate limits, data freshness, and everything else you need to know before you integrate.
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.
From the Blog
Stamped integration guides
Deep dives, architecture guides, and practical tutorials for building Stamped integrations.
Stamped
Get Stamped integrated into your app
Our team understands what it takes to make a Stamped integration successful. A short, crisp 30 minute call with folks who understand the problem.