---
title: "Enrich Orders Data"
method: POST
path: "/data-in/orders-enrichment"
tags: ["Data In"]
---

# Enrich Orders Data

`POST /data-in/orders-enrichment`

Use this endpoint to enrich existing orders—such as adding shipping costs or custom tags.  Note: Supported for data from platforms with a native Triple Whale integration  (e.g., Shopify, BigCommerce, WooCommerce).  Not supported for Custom Sales Platforms—to update these, resend the full order via the [Orders](https://triplewhale.readme.io/reference/create-order-record) endpoint.

## Request body

- object
  - `custom_expenses` number — Additional custom expenses associated with the order, in the currency of the order enriched. Must be non-negative.
  - `custom_gross_profit` number — Custom Gross Profit for the order, in the currency of the order being enriched. Must be non-negative.
  - `custom_gross_sales` number — Custom Gross Sales for the order, in the currency of the order being enriched. Must be non-negative.
  - `custom_net_revenue` number — Custom Net Revenue for the order, in the currency of the order being enriched. Must be non-negative.
  - `custom_number` number — A custom numeric value for the order, can be used for specialized calculations, references, or reporting.
  - `custom_status` string — A custom status label for the order, useful for filtering on statuses not captured by the built-in `status` field.
  - `custom_string` string — A free-form text field for storing additional metadata, internal notes, or other custom data relevant to this order.
  - `ignore_order` boolean — If true, the order is flagged to be ignored in standard reporting (e.g., to exclude test data or partial orders).
  - `order_id` string, required — The unique identifier for the order being enriched.
  - `orders_quantity` number — The quantity of orders to count for this single order_id. Must be 0 or 1.
  - `platform` string — The sales platform where the order being enriched was processed. Required for secondary sales platforms (e.g. Amazon), optional for main sales platform (e.g. Shopify).
  - `shipping_costs` number — Shipping costs paid by the seller for the order, in the currency of the order being enriched. Must be non-negative. To apply this value to your data, ensure **Default Shipping Costs** is selected in [Cost Settings](https://app.triplewhale.com/cost-settings) > Shipping.
  - `shop` string, required — The exact Shop URL (e.g., 'example.myshopify.com'). Must match the Shop URL value shown in [Settings → Store](https://app.triplewhale.com/store-settings/general). The API key owner must also have access to the shop, otherwise the request will return 403.
  - `total_items_quantity` number — The total number of items in the order. Must be non-negative.

## Response `200`

Order enrichment successfully received.

- object
  - `success` boolean
  - `message` string

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/triplewhale/apis/triple-whale-api.md) · [All operations](https://skmtc.net/triplewhale/apis/triple-whale-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/triplewhale/triple-whale-api/revisions/96b22ac9b5a7/schema)