POST/orders

Create order

Create a new order. Fields `id`, `createdAt`, `updatedAt` are auto-generated. Triggers `orders.created` webhook.

ReturnsOrder

AcceptsOrderInput

Bearer token required

Response examples

201Order created

application/json example derived from schema

{
  "id": 1,
  "userId": 1,
  "items": [
    {
      "productId": 37,
      "quantity": 2,
      "price": 416.97
    },
    {
      "productId": 16,
      "quantity": 2,
      "price": 478.87
    }
  ],
  "subtotal": 1791.68,
  "tax": 143.33,
  "shipping": 0,
  "total": 1935.01,
  "currency": "USD",
  "status": "pending",
  "paymentMethod": "credit_card",
  "shippingAddress": {
    "street": "6620 Maple Dr",
    "city": "Fort Worth",
    "state": "MI",
    "zipCode": "16372",
    "country": "US"
  },
  "trackingNumber": "TRK442765071",
  "notes": null,
  "createdAt": "2026-04-19T12:16:46.226Z",
  "updatedAt": "2025-01-30T04:10:54.855Z"
}

400400 — invalid input or malformed JSON

application/json

{
  "error": {
    "status": 400,
    "message": "Request body required"
  }
}

413413 — body exceeds 64 KB

application/json

{
  "error": {
    "status": 413,
    "message": "Request body too large",
    "details": {
      "maxSize": "64 KB"
    }
  }
}

429429 — rate limit exceeded (120/60s)

application/json

{
  "error": {
    "status": 429,
    "message": "Too many requests",
    "details": {
      "retryAfter": 45
    }
  }
}

Try ItMock API v2.0.1

Code examples

curl -X POST -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' -d '{
  "userId": 1,
  "items": [
    {
      "productId": 1,
      "quantity": 2,
      "price": 79.99
    },
    {
      "productId": 2,
      "quantity": 1,
      "price": 89
    }
  ],
  "subtotal": 248.98,
  "tax": 19.92,
  "shipping": 0,
  "total": 268.9,
  "currency": "USD",
  "paymentMethod": "credit_card",
  "shippingAddress": {
    "street": "123 Main St",
    "city": "Austin",
    "state": "TX",
    "zip": "78701",
    "country": "US"
  }
}' 'https://api.rodin.dev/mock/orders'

fetch("https://api.rodin.dev/mock/orders", {
  method: "POST",
  headers: {
      "Authorization": "Bearer <TOKEN>",
      "Content-Type": "application/json"
    },
  body: "{\n  \"userId\": 1,\n  \"items\": [\n    {\n      \"productId\": 1,\n      \"quantity\": 2,\n      \"price\": 79.99\n    },\n    {\n      \"productId\": 2,\n      \"quantity\": 1,\n      \"price\": 89\n    }\n  ],\n  \"subtotal\": 248.98,\n  \"tax\": 19.92,\n  \"shipping\": 0,\n  \"total\": 268.9,\n  \"currency\": \"USD\",\n  \"paymentMethod\": \"credit_card\",\n  \"shippingAddress\": {\n    \"street\": \"123 Main St\",\n    \"city\": \"Austin\",\n    \"state\": \"TX\",\n    \"zip\": \"78701\",\n    \"country\": \"US\"\n  }\n}",
})
  .then((response) => response.json())
  .then((data) => console.log(data))

import requests

url = "https://api.rodin.dev/mock/orders"
headers = {
    "Authorization": "Bearer <TOKEN>",
    "Content-Type": "application/json"
}
data = "{\n  \"userId\": 1,\n  \"items\": [\n    {\n      \"productId\": 1,\n      \"quantity\": 2,\n      \"price\": 79.99\n    },\n    {\n      \"productId\": 2,\n      \"quantity\": 1,\n      \"price\": 89\n    }\n  ],\n  \"subtotal\": 248.98,\n  \"tax\": 19.92,\n  \"shipping\": 0,\n  \"total\": 268.9,\n  \"currency\": \"USD\",\n  \"paymentMethod\": \"credit_card\",\n  \"shippingAddress\": {\n    \"street\": \"123 Main St\",\n    \"city\": \"Austin\",\n    \"state\": \"TX\",\n    \"zip\": \"78701\",\n    \"country\": \"US\"\n  }\n}"

response = requests.post(url, headers=headers, data=data)
print(response.json())

Authentication

Authentication

Bearer token

Paste cURL

Server:

https://api.rodin.dev/mockhttp://localhost:3002

Body:

{ "userId": 1, "items": [ { "productId": 1, "quantity": 2, "price": 79.99 }, { "productId": 2, "quantity": 1, "price": 89 } ], "subtotal": 248.98, "tax": 19.92, "shipping": 0, "total": 268.9, "currency": "USD", "paymentMethod": "credit_card", "shippingAddress": { "street": "123 Main St", "city": "Austin", "state": "TX", "zip": "78701", "country": "US" } }