---
title: "Order event"
method: POST
path: "/api/public/apps/{appId}/events/order"
tags: ["Custom Ecommerce Apps · Webhooks"]
---

# Order event

`POST /api/public/apps/{appId}/events/order`

Push a created/updated order. Routed into the standard ecommerce order pipeline for the resolved installation.

## Path parameters

- `appId` string, required

## Headers

- `x-vambe-timestamp` string, required
- `x-vambe-signature` string, required

## Request body

- CanonicalOrderEnvelopeDto
  - `external_store_id` string
  - `event_id` string
  - `order` object, required
    - `external_id` string
    - `external_name` string
    - `currency` string
    - `total_price` number
    - `status_url` string, uri, nullable
    - `details_url` string, uri, nullable
    - `customer` object
      - `name` string, nullable
      - `phone` string, nullable
      - `email` string, nullable
    - `line_items` object[]
      - `external_product_id` string, required
      - `quantity` integer, required
    - `metadata` object

## Response `201`

---

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