Skip to main content
POST
/
cart
cURL
curl --request POST \
  --url https://development.knotapi.com/cart \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "external_user_id": "abc123",
  "merchant_id": 46,
  "products": [
    {
      "external_id": "3324893784",
      "fulfillment": {
        "id": "5cfbe095d0cb9e597e316170d6ee9a6c667bddcde4a999222d2cc2b5bbfef7cf"
      }
    }
  ],
  "delivery_location": {
    "address": {
      "line1": "123 Main St",
      "line2": "Floor 4",
      "city": "Los Angeles",
      "region": "CA",
      "postal_code": "94105",
      "country": "US"
    },
    "first_name": "Ada",
    "last_name": "Lovelace",
    "phone_number": "+11234567890",
    "set_as_default": true
  },
  "simulate": "failed"
}'
{
  "message": "Success"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password. Use your client_id as the username and your secret as the password value.

Body

application/json

The input parameters required for adding products to a user's merchant cart.

​
external_user_id
string
required

Your unique identifier for the user.

Example:

"abc123"

​
merchant_id
integer
required

Unique identifier for the merchant.

Example:

46

​
products
object[]
required

List of products to add to the cart.

​
delivery_location
object
​
simulate
enum<string>

Simulate a failure in the development environment. The sync cart attempt fails.

Available options:
failed
Example:

"failed"

Response

Successful request.

​
message
string

Success message.

Example:

"Success"