Add cart

POST

https://api.mailchimp.com/3.0/ecommerce/stores/:store_id/carts

POST

/3.0/ecommerce/stores/:store_id/carts

curl -X POST https://api.mailchimp.com/3.0/ecommerce/stores/store_id/carts \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "currency_code": "string",
  "customer": {
    "id": "string"
  },
  "id": "string",
  "lines": [
    {
      "id": "string",
      "price": 1.1,
      "product_id": "string",
      "product_variant_id": "string",
      "quantity": 1
    }
  ],
  "order_total": 1.1
}'

200Successful

{
  "_links": [
    {
      "href": "string",
      "method": "GET",
      "rel": "string",
      "schema": "string",
      "targetSchema": "string"
    }
  ],
  "campaign_id": "839488a60b",
  "checkout_url": "string",
  "created_at": "2015-07-15T19:28:00+00:00",
  "currency_code": "string",
  "customer": {
    "_links": [
      {
        "href": "string",
        "method": "GET",
        "rel": "string",
        "schema": "string",
        "targetSchema": "string"
      }
    ],
    "address": {
      "address1": "675 Ponce de Leon Ave NE",
      "address2": "Suite 5000",
      "city": "Atlanta",
      "country": "United States",
      "country_code": "US",
      "postal_code": "30308",
      "province": "Georgia",
      "province_code": "GA"
    },
    "company": "string",
    "created_at": "2015-07-15T19:28:00+00:00",
    "email_address": "string",
    "first_name": "string",
    "id": "string",
    "last_name": "string",
    "opt_in_status": true,
    "orders_count": 4,
    "sms_phone_number": "string",
    "total_spent": 1.1,
    "updated_at": "2015-07-15T19:28:00+00:00"
  },
  "id": "string",
  "lines": [
    {
      "_links": [
        {
          "href": "string",
          "method": "GET",
          "rel": "string",
          "schema": "string",
          "targetSchema": "string"
        }
      ],
      "id": "string",
      "price": 1.1,
      "product_id": "string",
      "product_title": "string",
      "product_variant_id": "string",
      "product_variant_title": "string",
      "quantity": 1
    }
  ],
  "order_total": 1.1,
  "tax_total": 1.1,
  "updated_at": "2015-07-15T19:28:00+00:00"
}

Add a new cart to a store.

Authentication

AuthorizationBearer

Authorization using a Mailchimp API key (a.k.a. Bearer token)

AuthorizationBearer

Authorization using OAuth

Path parameters

store_idstringRequired

The store id.

Request

Information about a specific cart.

currency_codestringRequired

The three-letter ISO 4217 code for the currency that the cart uses.

customerobjectRequired

Information about a specific customer. For existing customers include only the id parameter in the customer object body.

idstring or integerRequired

A unique identifier for the cart.

lineslist of objectsRequired

An array of the cart's line items.

order_totaldouble or stringRequired

campaign_idstringOptional

A string that uniquely identifies the campaign for a cart.

checkout_urlstringOptional

The URL for the cart. This parameter is required for Abandoned Cart automations.

tax_totaldouble or stringOptional

Response

This endpoint returns an object.

_linkslist of objectsOptionalRead-only

A list of link types and descriptions for the API schema documents.

campaign_idstringOptional

A string that uniquely identifies the campaign associated with a cart.

checkout_urlstringOptional

The URL for the cart. This parameter is required for Abandoned Cart automations.

created_atdatetimeOptionalRead-only

The date and time the cart was created in ISO 8601 format.

currency_codestringOptional

The three-letter ISO 4217 code for the currency that the cart uses.

customerobjectOptional

Information about a specific customer.

idstringOptionalRead-only

A unique identifier for the cart.

lineslist of objectsOptional

An array of the cart's line items.

order_totaldoubleOptional

The order total for the cart.

tax_totaldoubleOptional

The total tax for the cart.

updated_atdatetimeOptionalRead-only

The date and time the cart was last updated in ISO 8601 format.