---
title: "New Cart"
method: POST
path: "/v1/cart/new"
tags: ["Merchant API"]
---

# New Cart

`POST /v1/cart/new`

## Request

- Base URL: `http://{{base_url}}`
- URL: `http://{{base_url}}/v1/cart/new`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover/docs/v1/cart/new/post.ts> (a function with typed inputs; its response is checked against the schema)

Set up a new Order Source connection to CartRover

### Post Fields
|    Field    |    Data Type    |    Length    |    Required?    |    Description    |
|------------------|-----------------|--------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|
|    cart_id    |    String    |        |    Y    |    Which cart to set up. See [/cart/listall](#a1c8ccd4-c9e2-4998-9997-5aeb31601f41)    |
|    user_key    |    String    |  |    N    |    User name/id for this API connection, if needed.    |
|    password    |    String    |  |    N    |    User password for this API connection, if needed.    |
|    server_id    |    String    | 250 |    N    |    Server URL for this connection, if needed.    |
|    description    |    String    | 100 |    N    |    Optional brief description for this connection    |
|    extra_params    |    Array    |  |  |    Array of additional settings to set for this cart. You can get a list of valid settings for each cart from the [/cart/listall](#a1c8ccd4-c9e2-4998-9997-5aeb31601f41) endpoint and valid WMS options from the [/wms/params](#99aefc50-34e7-4fa5-b944-9cbb24eaf594) endpoint.    |
|    schedules    |    Array    |  |  |    A list of schedules to set with the keys: order, confirm, inventory. Pass "ON" or "OFF" for each value.   |

### Array Response Fields
|    Field    |    Data Type    |    Length    |    Description    |
|----------------|-----------------|--------------|---------------------------------|
|    order_source   |    String    |  |    Order Source assigned to this connection    |
|    oauth_link    |    String    |  |    If this connection requires the user to grant access using oauth, it will be provided here.   |
|    test_success    |    Boolean    |  |    Did we successfully connect to the cart.   |
|    test_message    |    String    |  |    A testing result message will be returned. It may be an error message, or brief instructions if additional setup is needed.   |
|    extra_params    |    Array    |  |    List of all params set and their values, even if they are the system default.   |
|    schedules    |    Array    |  |    List of service schedules: order, confirm, inventory. A value of 0 is OFF, anything else means ON.   |

## Request body

- object

## Response `200`

OK

- object

---

[API](https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover.md) - [All operations](https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover/llms.txt) - [OpenAPI document](https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover/revisions/125e6deac675?raw)