Create a new order
const url = 'https://open-api.replyco.com/openapi/order';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json-patch+json'}, body: '{ "integrationId": "3f1c2a9e-6b4d-4c8e-9f2a-1d5e7b3c9a06", "customerId": "5c8a1e3f-7d2b-4f9c-8e6a-3b1d9f5c7e24", "marketOrderId": "SO-10482", "subject": "1x Walnut desk lamp", "purchaseDate": "2026-10-18T09:30:00Z", "orderTotalAmount": 89.5, "orderCurrency": "GBP", "paid": true, "status": "Shipped", "trackingNumber": "JD000000000000010482" }'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://open-api.replyco.com/openapi/order \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json-patch+json' \ --data '{ "integrationId": "3f1c2a9e-6b4d-4c8e-9f2a-1d5e7b3c9a06", "customerId": "5c8a1e3f-7d2b-4f9c-8e6a-3b1d9f5c7e24", "marketOrderId": "SO-10482", "subject": "1x Walnut desk lamp", "purchaseDate": "2026-10-18T09:30:00Z", "orderTotalAmount": 89.5, "orderCurrency": "GBP", "paid": true, "status": "Shipped", "trackingNumber": "JD000000000000010482" }'Creates a new order in the system for the authenticated user’s company.
Required fields:
integrationId— the marketplace account (integration) this order belongs tocustomerId— must reference an existing Replyco customer; useGET /customer/pagedto search orPOST /customerto create one first
Order items — two ways to attach products:
Option A — reference an existing product variation (recommended):
Set productVariationId to the ID of an existing variation and leave productVariation null.
This avoids duplicates because each variation enforces a unique marketId + SKU combination.
Option B — create a new product variation inline:
Leave productVariationId empty and populate the productVariation object.
If the variation has no parent product yet, also fill in productVariation.parentProduct
with the same details (SKU, name, etc.).
Always provide quantity and price for every item regardless of which option you use.
Sample request:
POST /order
{
"integrationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"customerId": "7cb8d3a1-1234-4abc-9def-000000000001",
"marketOrderId": "114-1234567-7654321",
"purchaseDate": "2024-06-01T10:30:00Z",
"orderTotalAmount": 59.98,
"orderCurrency": "USD",
"paid": true,
"status": "Pending",
"shippingService": "Royal Mail Tracked 48",
"shippingServiceCost": 4.99,
"trackingNumber": "JD000000000000000000",
"shipmentAddress": {
"addressLine1": "221B Baker Street",
"city": "London",
"postalCode": "NW1 6XE",
"country": "GB"
},
"orderItems": [
{
"productVariationId": "8fa85f64-5717-4562-b3fc-2c963f66afa6",
"quantity": 2,
"price": 29.99
}
]
}Authorizations
Section titled “Authorizations”Request Body
Section titled “Request Body”Order data. Only integrationId and customerId are required.
Input model for creating a new order.
Only IntegrationId and CustomerId are required — all other fields are optional
and should be filled in based on what data is available from your marketplace or system.
object
ID of the integration (marketplace account) this order belongs to. Find this on the Integrations page inside your Replyco account.
ID of the customer who placed the order.
Must reference an existing Replyco customer — use GET /customer/paged to search
or POST /customer to create one first.
The order ID as it appears on the marketplace (e.g. Amazon order number, eBay order ID, Shopify order name). This is the reference that both the buyer and seller recognise.
A short descriptive subject or label for the order, shown in the Replyco UI.
Direct URL to view this order on the marketplace or storefront.
Date and time the customer placed the order on the marketplace (UTC). Defaults to the current UTC time when omitted.
Latest date by which the order must be dispatched (UTC), as set by the marketplace SLA.
Total value of the order in its own currency (sum of all items, before or after discounts depending on how your marketplace reports it).
ISO 4217 three-letter currency code for this order.
Whether the order has already been paid by the buyer.
Payment method used by the buyer (e.g. PayPal, Credit Card, Bank Transfer).
Payment status of the order (e.g. Paid, Pending, Refunded).
Current fulfillment status of the order (e.g. Pending, Shipped, Cancelled).
Name of the shipping carrier or service used (e.g. Royal Mail Tracked 48, UPS Ground).
Shipping speed tier as defined by the marketplace (e.g. Standard, Expedited, NextDay).
Cost charged to the buyer for shipping.
Courier tracking number for the parcel, if already dispatched.
Date and time the order was physically dispatched (UTC). Only provide if the order is already shipped.
object
State or region
object
State or region
Full name of the shipment recipient, as it should appear on the shipping label.
Buyer’s username or marketplace-assigned user ID (e.g. eBay username).
Name of the shop or storefront on the marketplace this order originated from.
Line items included in this order.
Option A — reference an existing product variation (recommended):
Set ProductVariationId to the ID of an existing variation in Replyco and leave
ProductVariation null. This avoids duplicates since each variation enforces
a unique MarketId + SKU combination.
Option B — create a new product variation inline:
Leave ProductVariationId empty (Guid.Empty) and populate the
ProductVariation object. If the variation has no parent product yet, fill in
ProductVariation.ParentProduct with the same details (SKU, name, etc.).
Always set Quantity and Price per item regardless of which option you use.
object
Leave empty if attach new one on order creating
Ordered amount
Price per item in order
object
Leave empty if create new one with this variation
object
Spare string field for different integrations Shopify - parent product id (products it’s a variant of parent product)
Default = now
Internal notes to attach to the order (e.g. packing instructions, special customer requests).
Each note requires at minimum the Note text field.
object
Free-text comment about the order visible internally (e.g. a gift message or handling instruction).
Example
{ "integrationId": "3f1c2a9e-6b4d-4c8e-9f2a-1d5e7b3c9a06", "customerId": "5c8a1e3f-7d2b-4f9c-8e6a-3b1d9f5c7e24", "marketOrderId": "SO-10482", "subject": "1x Walnut desk lamp", "purchaseDate": "2026-10-18T09:30:00Z", "orderTotalAmount": 89.5, "orderCurrency": "GBP", "paid": true, "status": "Shipped", "trackingNumber": "JD000000000000010482"}Input model for creating a new order.
Only IntegrationId and CustomerId are required — all other fields are optional
and should be filled in based on what data is available from your marketplace or system.
object
ID of the integration (marketplace account) this order belongs to. Find this on the Integrations page inside your Replyco account.
Example
3fa85f64-5717-4562-b3fc-2c963f66afa6ID of the customer who placed the order.
Must reference an existing Replyco customer — use GET /customer/paged to search
or POST /customer to create one first.
Example
7cb8d3a1-1234-4abc-9def-000000000001The order ID as it appears on the marketplace (e.g. Amazon order number, eBay order ID, Shopify order name). This is the reference that both the buyer and seller recognise.
Example
114-1234567-7654321A short descriptive subject or label for the order, shown in the Replyco UI.
Example
2x Blue Widget – Prime shippingDirect URL to view this order on the marketplace or storefront.
Example
https://sellercentral.amazon.com/orders-v3/order/114-1234567-7654321Date and time the customer placed the order on the marketplace (UTC). Defaults to the current UTC time when omitted.
Example
2024-06-01T10:30:00ZLatest date by which the order must be dispatched (UTC), as set by the marketplace SLA.
Example
2024-06-03T23:59:00ZTotal value of the order in its own currency (sum of all items, before or after discounts depending on how your marketplace reports it).
Example
59.99ISO 4217 three-letter currency code for this order.
Example
USDWhether the order has already been paid by the buyer.
Example
truePayment method used by the buyer (e.g. PayPal, Credit Card, Bank Transfer).
Example
PayPalPayment status of the order (e.g. Paid, Pending, Refunded).
Example
PaidCurrent fulfillment status of the order (e.g. Pending, Shipped, Cancelled).
Example
PendingName of the shipping carrier or service used (e.g. Royal Mail Tracked 48, UPS Ground).
Example
Royal Mail Tracked 48Shipping speed tier as defined by the marketplace (e.g. Standard, Expedited, NextDay).
Example
ExpeditedCost charged to the buyer for shipping.
Example
4.99Courier tracking number for the parcel, if already dispatched.
Example
JD000000000000000000Date and time the order was physically dispatched (UTC). Only provide if the order is already shipped.
Example
2024-06-02T14:00:00Zobject
State or region
object
State or region
Full name of the shipment recipient, as it should appear on the shipping label.
Example
Jane SmithBuyer’s username or marketplace-assigned user ID (e.g. eBay username).
Example
buyer_jane_99Name of the shop or storefront on the marketplace this order originated from.
Example
My eBay StoreLine items included in this order.
Option A — reference an existing product variation (recommended):
Set ProductVariationId to the ID of an existing variation in Replyco and leave
ProductVariation null. This avoids duplicates since each variation enforces
a unique MarketId + SKU combination.
Option B — create a new product variation inline:
Leave ProductVariationId empty (Guid.Empty) and populate the
ProductVariation object. If the variation has no parent product yet, fill in
ProductVariation.ParentProduct with the same details (SKU, name, etc.).
Always set Quantity and Price per item regardless of which option you use.
object
Leave empty if attach new one on order creating
Ordered amount
Price per item in order
object
Leave empty if create new one with this variation
object
Spare string field for different integrations Shopify - parent product id (products it’s a variant of parent product)
Default = now
Internal notes to attach to the order (e.g. packing instructions, special customer requests).
Each note requires at minimum the Note text field.
object
Free-text comment about the order visible internally (e.g. a gift message or handling instruction).
Example
Please leave at the front door.Input model for creating a new order.
Only IntegrationId and CustomerId are required — all other fields are optional
and should be filled in based on what data is available from your marketplace or system.
object
ID of the integration (marketplace account) this order belongs to. Find this on the Integrations page inside your Replyco account.
Example
3fa85f64-5717-4562-b3fc-2c963f66afa6ID of the customer who placed the order.
Must reference an existing Replyco customer — use GET /customer/paged to search
or POST /customer to create one first.
Example
7cb8d3a1-1234-4abc-9def-000000000001The order ID as it appears on the marketplace (e.g. Amazon order number, eBay order ID, Shopify order name). This is the reference that both the buyer and seller recognise.
Example
114-1234567-7654321A short descriptive subject or label for the order, shown in the Replyco UI.
Example
2x Blue Widget – Prime shippingDirect URL to view this order on the marketplace or storefront.
Example
https://sellercentral.amazon.com/orders-v3/order/114-1234567-7654321Date and time the customer placed the order on the marketplace (UTC). Defaults to the current UTC time when omitted.
Example
2024-06-01T10:30:00ZLatest date by which the order must be dispatched (UTC), as set by the marketplace SLA.
Example
2024-06-03T23:59:00ZTotal value of the order in its own currency (sum of all items, before or after discounts depending on how your marketplace reports it).
Example
59.99ISO 4217 three-letter currency code for this order.
Example
USDWhether the order has already been paid by the buyer.
Example
truePayment method used by the buyer (e.g. PayPal, Credit Card, Bank Transfer).
Example
PayPalPayment status of the order (e.g. Paid, Pending, Refunded).
Example
PaidCurrent fulfillment status of the order (e.g. Pending, Shipped, Cancelled).
Example
PendingName of the shipping carrier or service used (e.g. Royal Mail Tracked 48, UPS Ground).
Example
Royal Mail Tracked 48Shipping speed tier as defined by the marketplace (e.g. Standard, Expedited, NextDay).
Example
ExpeditedCost charged to the buyer for shipping.
Example
4.99Courier tracking number for the parcel, if already dispatched.
Example
JD000000000000000000Date and time the order was physically dispatched (UTC). Only provide if the order is already shipped.
Example
2024-06-02T14:00:00Zobject
State or region
object
State or region
Full name of the shipment recipient, as it should appear on the shipping label.
Example
Jane SmithBuyer’s username or marketplace-assigned user ID (e.g. eBay username).
Example
buyer_jane_99Name of the shop or storefront on the marketplace this order originated from.
Example
My eBay StoreLine items included in this order.
Option A — reference an existing product variation (recommended):
Set ProductVariationId to the ID of an existing variation in Replyco and leave
ProductVariation null. This avoids duplicates since each variation enforces
a unique MarketId + SKU combination.
Option B — create a new product variation inline:
Leave ProductVariationId empty (Guid.Empty) and populate the
ProductVariation object. If the variation has no parent product yet, fill in
ProductVariation.ParentProduct with the same details (SKU, name, etc.).
Always set Quantity and Price per item regardless of which option you use.
object
Leave empty if attach new one on order creating
Ordered amount
Price per item in order
object
Leave empty if create new one with this variation
object
Spare string field for different integrations Shopify - parent product id (products it’s a variant of parent product)
Default = now
Internal notes to attach to the order (e.g. packing instructions, special customer requests).
Each note requires at minimum the Note text field.
object
Free-text comment about the order visible internally (e.g. a gift message or handling instruction).
Example
Please leave at the front door.Input model for creating a new order.
Only IntegrationId and CustomerId are required — all other fields are optional
and should be filled in based on what data is available from your marketplace or system.
object
ID of the integration (marketplace account) this order belongs to. Find this on the Integrations page inside your Replyco account.
Example
3fa85f64-5717-4562-b3fc-2c963f66afa6ID of the customer who placed the order.
Must reference an existing Replyco customer — use GET /customer/paged to search
or POST /customer to create one first.
Example
7cb8d3a1-1234-4abc-9def-000000000001The order ID as it appears on the marketplace (e.g. Amazon order number, eBay order ID, Shopify order name). This is the reference that both the buyer and seller recognise.
Example
114-1234567-7654321A short descriptive subject or label for the order, shown in the Replyco UI.
Example
2x Blue Widget – Prime shippingDirect URL to view this order on the marketplace or storefront.
Example
https://sellercentral.amazon.com/orders-v3/order/114-1234567-7654321Date and time the customer placed the order on the marketplace (UTC). Defaults to the current UTC time when omitted.
Example
2024-06-01T10:30:00ZLatest date by which the order must be dispatched (UTC), as set by the marketplace SLA.
Example
2024-06-03T23:59:00ZTotal value of the order in its own currency (sum of all items, before or after discounts depending on how your marketplace reports it).
Example
59.99ISO 4217 three-letter currency code for this order.
Example
USDWhether the order has already been paid by the buyer.
Example
truePayment method used by the buyer (e.g. PayPal, Credit Card, Bank Transfer).
Example
PayPalPayment status of the order (e.g. Paid, Pending, Refunded).
Example
PaidCurrent fulfillment status of the order (e.g. Pending, Shipped, Cancelled).
Example
PendingName of the shipping carrier or service used (e.g. Royal Mail Tracked 48, UPS Ground).
Example
Royal Mail Tracked 48Shipping speed tier as defined by the marketplace (e.g. Standard, Expedited, NextDay).
Example
ExpeditedCost charged to the buyer for shipping.
Example
4.99Courier tracking number for the parcel, if already dispatched.
Example
JD000000000000000000Date and time the order was physically dispatched (UTC). Only provide if the order is already shipped.
Example
2024-06-02T14:00:00Zobject
State or region
object
State or region
Full name of the shipment recipient, as it should appear on the shipping label.
Example
Jane SmithBuyer’s username or marketplace-assigned user ID (e.g. eBay username).
Example
buyer_jane_99Name of the shop or storefront on the marketplace this order originated from.
Example
My eBay StoreLine items included in this order.
Option A — reference an existing product variation (recommended):
Set ProductVariationId to the ID of an existing variation in Replyco and leave
ProductVariation null. This avoids duplicates since each variation enforces
a unique MarketId + SKU combination.
Option B — create a new product variation inline:
Leave ProductVariationId empty (Guid.Empty) and populate the
ProductVariation object. If the variation has no parent product yet, fill in
ProductVariation.ParentProduct with the same details (SKU, name, etc.).
Always set Quantity and Price per item regardless of which option you use.
object
Leave empty if attach new one on order creating
Ordered amount
Price per item in order
object
Leave empty if create new one with this variation
object
Spare string field for different integrations Shopify - parent product id (products it’s a variant of parent product)
Default = now
Internal notes to attach to the order (e.g. packing instructions, special customer requests).
Each note requires at minimum the Note text field.
object
Free-text comment about the order visible internally (e.g. a gift message or handling instruction).
Example
Please leave at the front door.Responses
Section titled “Responses”Order created successfully — returns the full order model.
object
Default = now
Spare bool field for different integrations For Shopify = true if order is draft
Customer field only for model, because some markets api sent order with customer
Json string format
Number order id(which visible for user)
object
State or region
object
State or region
If you have products or variations already you have to use them instead of create the same, because of unique MarketId and SKU rule
object
Leave empty if attach new one on order creating
Ordered amount
Price per item in order
object
Leave empty if create new one with this variation
object
Spare string field for different integrations Shopify - parent product id (products it’s a variant of parent product)
Default = now
object
Example
{ "id": "5b7e9c1d-2f4a-4b6c-8d0e-1f2a3b4c5d6e", "integrationId": "8a1b1d6c-5f1a-4c8e-9f2b-7d3e5a9c1b40", "customerId": "3f1c2a9e-7b4d-4e2f-9a6c-1d5e8b7f0a23", "marketOrderId": "EX-100245", "purchaseDate": "2026-10-20T09:15:00Z", "createdDate": "2026-10-20T09:15:00Z", "orderTotalAmount": 59.98, "orderCurrency": "GBP", "paid": true, "status": "Pending", "trackingNumber": "EX123456789GB", "orderItems": [ { "productVariationId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f", "quantity": 2, "price": 29.99 } ]}Request validation failed (missing required fields or malformed body).
Missing or invalid authentication token.