Flype Order API
  1. Webhook
  • Flype Order API
    • Shipments
      • Rates
      • Create Bulk Orders
      • All Shipments
      • Shipments Count
      • Shipment Details
      • Shipment Last Status
      • Cancel Shipment
      • Get Shipping Label
    • Webhook
      • Webhook: Shipment status updates (Flype → Your Server)
        POST
    • Locations
      • Upsert Pickup Location
      • Get Saved Pickup Locations
      • Fetch Pickup Location Details
    • Schemas
      • ApiStatus
      • ErrorResponse
      • ShipmentsCountResponse
      • AllShipmentsRequest
      • ShipmentSummary
      • AllShipmentsResponse
      • BulkOrderRequest
      • BulkOrderResponse
      • SchedulePickupRequest
      • SchedulePickupResponse
      • City
      • GetCitiesResponse
      • ShipmentDetailsResponse
      • ShipmentLastStatusResponse
      • CancelShipmentResponse
      • LabelResponse
      • Country
      • CountriesResponse
      • ShipmentStatusWebhook
      • PlaceBulkItem
      • SuccessMessageResponse
      • PlaceBulkAddress
      • BooleanDataResponse
      • PlaceBulkPickupLocation
      • ShipmentAddress
      • PlaceBulkShipment
      • ShipmentRecipient
      • PlaceBulkAcceptedOrder
      • ShipmentRetailerAddress
      • PlaceBulkDeniedOrder
      • ShipmentRetailer
      • BulkOrderResponseData
      • ShipmentDriver
      • ShipmentStatusHistoryEntry
      • DeliverySettings
      • DropOffDetails
      • AllShipmentsItem
      • CitiesResponse
      • AirwayBillResponse
      • WebhookShipmentStatusUpdate
      • WebhookAckResponse
      • PlaceBulkDeliveryAddress
      • PlaceBulkRequest
  1. Webhook

Webhook: Shipment status updates (Flype → Your Server)

POST
/flype/webhook/shipment-status

Webhook — Shipment status updates (Flype → Your API)#

Flype will send real-time shipment status updates to a webhook endpoint hosted by your system.
✅ Action required: Provide your webhook URL to Flype during onboarding so Flype can call it when shipment statuses change.
Authentication / Verification
This endpoint is called by Flype (not by you). Do not use the Flype API Bearer token here.
Verify requests using one of the following:
Shared token header: X-Flype-Webhook-Token: <shared_secret>
Headers
Content-Type: application/json
X-Flype-Webhook-Token: <shared_secret> (if enabled)
Response
Return any 2xx status code to acknowledge receipt.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Acknowledgement
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/flype/webhook/shipment-status' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "trackingNumber": "F78ECYH0BNZ8",
    "status": "delivered",
    "orderDate": "2025-10-30T15:12:34.000Z"
}'
Response Response Example
{
    "status": true
}
Previous
Get Shipping Label
Next
Upsert Pickup Location
Built with