---
title: "v2-reportOrderActions - Log order action results and errors"
method: POST
path: "/v2/orders/actions"
tags: ["Orders"]
---

# v2-reportOrderActions - Log order action results and errors

`POST /v2/orders/actions`

<div class="extension-title">Description</div>

Use this API to report to Connect the results of actions performed on orders in your system, such as synchronizing  back orders. This enables enhanced error tracking while providing a centralized view of all  order actions and errors within the Connect interface.

We recommend integrating this API when developing a connector, such as for a CMS, to ensure comprehensive tracking  of order actions and errors. This integration is optional if you process orders directly via the Connect API without using a connector.


<div class="api-description-extension">
<div class="extension-title">Call Frequency</div>

<div class="recommended-call-frequency">Recommended usage: Every 5 minutes</div>
<div class="max-call-frequency">Maximum usage: Once per minute</div>
</div>

## Request body

- ActionRequest
  - `actions` ActionItemRequest[], required — List of actions to report
    - `entity_id` string, required — Unique entity identifier used by Mirakl Connect.
    - `entity_type` string, required — Enum: `"ORDER"`
    - `errors` ActionError[] — List of errors encountered during action execution. Should not be null if the status is `FAILED`.
      - `code` string, required — Enum: `"INVALID_INPUT"`, `"DATA_NOT_FOUND"`, `"UNEXPECTED"`, `"UNAVAILABLE"`, `"TOO_MANY_REQUEST"`, `"ACTION_NOT_SUPPORTED"`, `"ORDER_IN_WRONG_STATE"`, `"INVALID_PRODUCT_ID"`, `"OUT_OF_STOCK"`, `"RETURN_IN_WRONG_STATE"`, `"OTHER"`
      - `message` string, required — Human-readable error message
    - `executed_at` string, date-time, required — Date and time of the action in ISO 8601 format (UTC/Zulu time).
    - `status` string, required — Enum: `"FAILED"`, `"SUCCESS"`
    - `type` string, required — Enum: `"SYNCHRONIZE_ORDER"`, `"SYNCHRONIZE_ORDER_UPDATE"`

## Response `200`

Action successfully created

- ActionsCreatedResponse
  - `actions` ActionCreatedResponse[], required — List of created actions ids
    - `action_id` string, required — The unique identifier for the action.

## Other responses

- `400` — Invalid request - input does not match schema or contains invalid values

---

[API](https://skmtc.net/mirakl/apis/mirakl-connect-apis.md) · [All operations](https://skmtc.net/mirakl/apis/mirakl-connect-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mirakl/mirakl-connect-apis/revisions/cc009fec5cdd/schema)