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

# Fulfillment event

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

Push a shipment/fulfillment. Linked to its order even if it arrives before the order webhook.

## Path parameters

- `appId` string, required

## Headers

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

## Request body

- CanonicalFulfillmentEnvelopeDto
  - `external_store_id` string
  - `event_id` string
  - `fulfillment` object, required
    - `order_external_id` string
    - `fulfillment_external_id` string
    - `tracking_number` string, nullable
    - `type` 'delivery' | 'pickup'
    - `delivery_address` object, nullable
      - `recipient_name` string, nullable
      - `phone` string, nullable
      - `address_line_1` string, nullable
      - `address_line_2` string, nullable
      - `city` string, nullable
      - `region` string, nullable
      - `country` string, nullable
      - `postal_code` string, nullable

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