---
title: "Create Event"
method: POST
path: "/v4/track/events/"
tags: ["Events"]
---

# Create Event

`POST /v4/track/events/`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

## Request body

- union
  - EventSchemaTracking
    - `event_timestamp` string, date-time: Timestamp of the event
    - `location` string: Location of the event
    - `event_status` 'WarehousePending' | 'WarehousePrepared' | 'WarehouseDelay' | 'Loaded' | 'InboundScan' | 'InTransit' | 'ExportHub' | 'ImportHub' | 'CustomsIn' | 'CustomsReleased' | 'Exception-AddressIssue' | 'Exception-CustomerRefusal' | 'Exception-Customs' | 'Exception-Damaged' | 'Exception-DeliveryPayment' | 'Exception-IdentFailed' | 'Exception-ItemMissing' | 'Exception-Notified' | 'Exception-Strike' | 'ScheduledDelivery ###' | 'ScheduledTomorrow' | 'DestinationDeliveryCenter' | 'OutForDelivery' | 'FailedAttempt-NewAttemptNextDay' | 'FailedAttempt-NewAttemptToday' | 'FailedAttempt-PickUpReady' | 'FailedAttempt-Scheduled ###' | 'PickupReady' | 'PickupReady, collect at ###' | 'Delivered' | 'Delivered-Doorstep' | 'Delivered-HomeDeposit' | 'Delivered-Neighbor' | 'Delivered-Notified' | 'Delivered-ParcelLocker' | 'Delivered-ParcelShop' | 'Delivered-Postbox' | 'ReturnToSender-Damaged' | 'ReturnToSender-DeliveryPayment' | 'ReturnToSender-NotCollected' | 'ReturnToSender-Recall' | 'ReturnDroppedOff' | 'ReturnInProcess' | 'ReturnDelivered' | 'ReturnRefunded' | 'RMAProcessed', required
    - `event_details` string: Message of the event
    - `placeholder_value` string: Placeholder value for events with specifics, such as 'ScheduledDelivery ###'
    - `courier` string, required: Key of the courier, if available (required, unless reference number is provided)
    - `tracking_number` string, required: Tracking number of the shipment, if available. If no tracking number is available, reference number must be used.
  - EventSchemaReference
    - `event_timestamp` string, date-time: Timestamp of the event
    - `location` string: Location of the event
    - `event_status` 'WarehousePending' | 'WarehousePrepared' | 'WarehouseDelay' | 'Loaded' | 'InboundScan' | 'InTransit' | 'ExportHub' | 'ImportHub' | 'CustomsIn' | 'CustomsReleased' | 'Exception-AddressIssue' | 'Exception-CustomerRefusal' | 'Exception-Customs' | 'Exception-Damaged' | 'Exception-DeliveryPayment' | 'Exception-IdentFailed' | 'Exception-ItemMissing' | 'Exception-Notified' | 'Exception-Strike' | 'ScheduledDelivery ###' | 'ScheduledTomorrow' | 'DestinationDeliveryCenter' | 'OutForDelivery' | 'FailedAttempt-NewAttemptNextDay' | 'FailedAttempt-NewAttemptToday' | 'FailedAttempt-PickUpReady' | 'FailedAttempt-Scheduled ###' | 'PickupReady' | 'PickupReady, collect at ###' | 'Delivered' | 'Delivered-Doorstep' | 'Delivered-HomeDeposit' | 'Delivered-Neighbor' | 'Delivered-Notified' | 'Delivered-ParcelLocker' | 'Delivered-ParcelShop' | 'Delivered-Postbox' | 'ReturnToSender-Damaged' | 'ReturnToSender-DeliveryPayment' | 'ReturnToSender-NotCollected' | 'ReturnToSender-Recall' | 'ReturnDroppedOff' | 'ReturnInProcess' | 'ReturnDelivered' | 'ReturnRefunded' | 'RMAProcessed', required
    - `event_details` string: Message of the event
    - `placeholder_value` string: Placeholder value for events with specifics, such as 'ScheduledDelivery ###'
    - `account` integer, required: ID of the account
    - `reference_number` string, required: Reference number of the shipment, if no tracking number is available
  - EventSchemaOrder
    - `event_timestamp` string, date-time: Timestamp of the event
    - `location` string: Location of the event
    - `event_status` 'WarehousePending' | 'WarehousePrepared' | 'WarehouseDelay' | 'Loaded' | 'InboundScan' | 'InTransit' | 'ExportHub' | 'ImportHub' | 'CustomsIn' | 'CustomsReleased' | 'Exception-AddressIssue' | 'Exception-CustomerRefusal' | 'Exception-Customs' | 'Exception-Damaged' | 'Exception-DeliveryPayment' | 'Exception-IdentFailed' | 'Exception-ItemMissing' | 'Exception-Notified' | 'Exception-Strike' | 'ScheduledDelivery ###' | 'ScheduledTomorrow' | 'DestinationDeliveryCenter' | 'OutForDelivery' | 'FailedAttempt-NewAttemptNextDay' | 'FailedAttempt-NewAttemptToday' | 'FailedAttempt-PickUpReady' | 'FailedAttempt-Scheduled ###' | 'PickupReady' | 'PickupReady, collect at ###' | 'Delivered' | 'Delivered-Doorstep' | 'Delivered-HomeDeposit' | 'Delivered-Neighbor' | 'Delivered-Notified' | 'Delivered-ParcelLocker' | 'Delivered-ParcelShop' | 'Delivered-Postbox' | 'ReturnToSender-Damaged' | 'ReturnToSender-DeliveryPayment' | 'ReturnToSender-NotCollected' | 'ReturnToSender-Recall' | 'ReturnDroppedOff' | 'ReturnInProcess' | 'ReturnDelivered' | 'ReturnRefunded' | 'RMAProcessed', required
    - `event_details` string: Message of the event
    - `placeholder_value` string: Placeholder value for events with specifics, such as 'ScheduledDelivery ###'
    - `account` integer, required: ID of the account
    - `order_number` string, required: Order number of the shipment

## Response `204`

No response body

## Other responses

- `400`
- `403`
- `404`

## Changes

- **2026-11-03** `84524f38b6c9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/parcellab/apis/parcellab-api/changes/v4/track/events/post.md)

---

[API](https://skmtc.dev/parcellab/apis/parcellab-api.md) - [All operations](https://skmtc.dev/parcellab/apis/parcellab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/parcellab/apis/parcellab-api/revisions/84524f38b6c9?raw)