Skip to content
Reponse.ai LogoDocs
DocsAPISDKsGuides

Search Documentation

Search for an article...

Getting Started

  • Overview
  • Architecture
  • Installation
  • Authentication
  • First Request

Products & Collections

  • Products — List
  • Products — Get
  • Products — Metafields
  • Collections — List
  • Collections — Get
  • Collections — Products

Cart & Checkout

  • Cart — Create
  • Cart — Get
  • Cart — Add Item
  • Cart — Update Item
  • Cart — Remove Item
  • Cart — Apply Promotion
  • Checkout — Stripe
  • Checkout — Payment Intent
  • Checkout — ACP

Orders & Fulfillment

  • Orders — Create
  • Orders — Get
  • Orders — Confirm
  • Orders — Cancel
  • Orders — Fulfill
  • Orders — Refund

Commerce

  • Inventory — Get
  • Inventory — Update
  • Shipping — Rates
  • Discounts — List
  • Discounts — Create
  • Discounts — Validate
  • Subscriptions — Manage

Loyalty & Gift Cards

  • Loyalty — Balance
  • Loyalty — Redeem
  • Loyalty — Referral
  • Gift Cards — List
  • Gift Cards — Redeem

Tickets & Support

  • Tickets — List
  • Tickets — Create
  • Tickets — Reply

Platform

  • Product Feed — JSON
  • Product Feed — CSV
  • Theme — Get
  • Approvals — Execute
  • Approvals — Reject
  • Geocode

SDKs

  • SDK Overview
  • TypeScript SDK
  • React Hooks

Guides

  • Chat Widget
  • Shopify Sync
  • Storefront Starter
  • Loyalty Program
  • Discounts & Promotions
  • Subscriptions
  • Klaviyo Integration
  • Custom Domains
  • Agentic Commerce (ACP)
  • A2A Protocol
  • AI Engines
  • MCP Server

Webhooks

  • Webhooks Overview
  • Events Reference
  • Shopify Webhooks
  • Stripe Webhooks
  • Reviews (Stamped / Trustpilot)
  • Logistics
  • Email Inbound

Resources

  • Environment Variables
  • Rate Limits
  • Changelog
DocsCart & CheckoutCart — Create

Cart — Create

Create a new shopping cart with initial items.

1 min read/Last updated Jul 22, 2026
On this page

Overview

Create a new shopping cart with initial items.

Authentication

This endpoint requires a Bearer token. Include your workspace API key in the `Authorization` header.

Authorization: Bearer <your_api_key>

Request

**POST** `/v1/carts`

Request Body

json
{
  "items": [
    { "product_id": "uuid", "quantity": 2 }
  ],
  "currency": "EUR"
}

Response

json
{
  "id": "cart_uuid",
  "items": [
    {
      "id": "line_uuid",
      "product_id": "uuid",
      "variant_id": "variant_uuid",
      "quantity": 2,
      "price": 29.99
    }
  ],
  "subtotal": 59.98,
  "currency": "EUR",
  "created_at": "2025-01-01T00:00:00Z"
}

Code Examples

cURL

bash
curl -X POST https://api.reponse.ai/v1/carts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    { "product_id": "uuid", "quantity": 2 }
  ],
  "currency": "EUR"
}'

TypeScript

typescript
const response = await fetch("https://api.reponse.ai/v1/carts", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "items": [
    { "product_id": "uuid", "quantity": 2 }
  ],
  "currency": "EUR"
}),
});

const data = await response.json();
console.log(data);

Error Codes

StatusDescription
400Bad Request — Invalid parameters
401Unauthorized — Invalid or missing API key
404Not Found — Resource does not exist
500Internal Server Error

Related

  • Get cart
  • Add item to cart
  • Checkout — Stripe
PreviousCollections — Products
NextCart — Get