Many Propago customers run other platforms alongside their Propago storefront — internal ordering portals, CRM systems, email campaign tools, ERP systems, and more. Until now, getting a user from one of those platforms into the right place in Propago meant asking them to log in, navigate to the right product, and build their cart from scratch. The new CreateShoppingCart API endpoint eliminates that friction entirely, letting your integration generate a secure link that drops a user directly into a pre-populated Propago cart or onto a specific product page — ready to review and check out.
If your organization has developers or a technical team building integrations with Propago, this feature opens up powerful new ordering workflows. If your Propago partner manages integrations on your behalf, this is worth passing along to them.
Benefits to You
- Remove friction from the ordering process — instead of asking users to navigate Propago and build a cart themselves, your external system can send them straight to a fully loaded cart, ready for checkout.
- Support configurable and custom products — for products that require customization, sizing, or attribute selection, send users directly to the product page so they can make their choices before proceeding to the cart.
- Include upload files automatically — if an order requires a customer-supplied file (like artwork or a PDF), your integration can pass the file along at the same time, so it’s already attached when the user arrives.
- Work across multiple product types — the integration supports static products, upload-capable products, kits, and configurable products, covering the majority of what Propago storefronts offer.
- Simplify user access — if the user doesn’t already have a Propago account, the endpoint can automatically create one for them as part of the same request, keeping the experience seamless.
How It Works
The endpoint supports two distinct flows. Choose the one that fits your use case:
Flow 1: Send the user directly to the cart (ShoppingCart)
Use this when you already know exactly what the user needs to order. The cart arrives pre-populated with the products and quantities you specify.
- Your integration makes an API call to
POST /v2/shoppingcart/createusing a Propago API credential that has been set up with the appropriate access for your company’s storefront. - The request includes the user’s email address, the products (by SKU) and quantities to pre-load, and
"redirectPage": "ShoppingCart". - Propago returns a short-lived secure link (valid for approximately 3 minutes).
- Your application redirects the user to that link.
- The user lands in the Propago shopping cart with their items already loaded and proceeds through checkout normally.
Flow 2: Send the user to a product page for customization (ProductPage)
Use this when the product requires configuration, attribute selection, or other choices the user needs to make before the item goes into the cart.
- Your integration makes an API call to
POST /v2/shoppingcart/createwith"redirectPage": "ProductPage"and a single product SKU. - Propago returns a short-lived secure link.
- Your application redirects the user to that link.
- The user lands on the product’s page in Propago, where they can configure options, select attributes, adjust quantity, and add the item to their cart — then proceed through checkout normally.
Important Notes
- The secure link returned by the API expires quickly (approximately 3 minutes) and is intended for immediate use. Redirect the user to the link right away — do not store it for later.
- The ShoppingCart flow supports multiple products in a single cart. The ProductPage flow supports one product at a time.
- The session created by this integration is scoped to the cart and checkout path. It ends once the user completes final checkout.
- This feature requires a Propago API credential configured with SingleSignOn and Company access, scoped to the target site and company. If you are not sure whether your organization has this set up, contact your Propago account team.
If your organization has an integration team or works with a developer who builds connections to your Propago storefront, this endpoint opens up a new category of ordering workflows. We encourage you to share this article with them and explore what’s possible.
As always, if you have questions about whether this feature is a fit for your workflows or need help getting started, reach out to your Propago account team — we’re happy to help.
For complete technical documentation on the capabilities covered in this article, including full request and response schemas, code examples in multiple languages, and integration checklists, refer to the guides below:
