---
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`

## Request

- Base URL: `https://miraklconnect.com/api`
- URL: `https://miraklconnect.com/api/v2/orders/actions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/mirakl/apis/mirakl-connect-apis/docs/v2/orders/actions/post.ts> (a function with typed inputs; its response is checked against the schema)

<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` 'ORDER', required
    - `errors` ActionError[]: List of errors encountered during action execution. Should not be null if the status is `FAILED`.
      - `code` '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', required
      - `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` 'FAILED' | 'SUCCESS', required
    - `type` 'SYNCHRONIZE_ORDER' | 'SYNCHRONIZE_ORDER_UPDATE', required

## 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

## Changes

- **2026-10-14** `d12b10bceb6a`: 4 breaking, 16 info
  - request property `actions/items/entity_type` was restricted to a list of enum values
  - request property `actions/items/errors/items/code` was restricted to a list of enum values
  - request property `actions/items/status` was restricted to a list of enum values
  - request property `actions/items/type` was restricted to a list of enum values
  - …16 more

[Operation history](https://skmtc.dev/mirakl/apis/mirakl-connect-apis/changes/v2/orders/actions/post.md)

---

[API](https://skmtc.dev/mirakl/apis/mirakl-connect-apis.md) - [All operations](https://skmtc.dev/mirakl/apis/mirakl-connect-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/mirakl/apis/mirakl-connect-apis/revisions/c0527a972b89?raw)