Oto Global Webhooks

generated: '2026-07-20'
method: searched
source: https://apis.tryoto.com/ (OTO API V2 Webhook folder) + postman/oto-global-postman.json
spec_type: Webhooks
summary: >-
  OTO pushes real-time updates to a merchant-registered HTTPS endpoint. Webhooks are
  registered and managed through the /rest/v2/webhook endpoint (POST create, GET list,
  PUT update, DELETE remove). All timestamps are UTC.
management:
  register: { method: POST, url: https://api.tryoto.com/rest/v2/webhook }
  list: { method: GET, url: https://api.tryoto.com/rest/v2/webhook }
  update: { method: PUT, url: https://api.tryoto.com/rest/v2/webhook }
  delete: { method: DELETE, url: https://api.tryoto.com/rest/v2/webhook }
events:
  - type: orderStatus
    description: Fired whenever an order status changes (Processing, Delivered, Returned, etc.).
    sample_fields: [orderId, parentOrderId, returnOrderId, otoId, entityId, brandedTrackingURL, status, timestamp]
  - type: shipmentError
    description: Fired when an error occurs while creating/processing an order shipment; carries error detail.
  - type: newOrders
    description: Pushes full order details so an external WMS can create the order in its own system.
  - type: walletTransaction
    description: Pushes wallet transaction details (credit usage, charges, refunds, balance updates) for financial reconciliation.
notes:
  - timestamp values are in the UTC time zone.
  - orderStatus payload includes a brandedTrackingURL for customer-facing tracking.