Push API Sales

Webhook/winkelstraat/push api/v2/track

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://push-api.doc.winkelstraat.nl/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Push API Sales MCP server": {
    "url": "https://push-api.doc.winkelstraat.nl/mcp"
  }
}
Close
POST https://webhook.example.com

What it does. Provides the tracking details for a shipment — the carrier, track number, and tracking-label URLs.

When it is sent. When both a track and its corresponding shipping label have been created.

Version. Recommended (V2).

Headers

  • x-version string Required

    Version of the webhook.

  • x-api-key string

    The API-key is a shared secret that can be used to authenticate the incoming request.

application/json

Body

  • track_number string Required

    Carrier tracking number.

  • carrier_code string Required

    Code of the shipping carrier (e.g. ups, dhlparcel, tig_postnl).

  • shipment_id string Required

    Winkelstraat shipment increment ID (e.g. 000000284).

  • last_modified string(date-time) Required

    Date/time the track was last modified.

  • shipping_method string Required

    Human-readable shipping method / carrier title used for this shipment.

  • order_id string Required

    Winkelstraat order increment ID (e.g. 000000549).

  • track_id string Required

    Opaque identifier of the track.

  • tracking_label_url_a6 string Required

    URL to the A6-format (PDF) shipping label.

  • tracking_label_url_orig string Required

    URL to the original-format shipping label.

  • tracking_url string Required

    Public carrier tracking URL for the customer.

Responses

  • 200 application/json

    Delivered. Return any 2xx status to acknowledge receipt; the response body may be empty or contain anything, as Winkelstraat does not read it. Any 2xx response is treated as a successful delivery and the webhook is not retried.

    No response body is expected; Winkelstraat does not read it. Returning a 2xx with an empty body is sufficient.
  • 202

    Accepted for asynchronous processing. Treated the same as 200 — the webhook is not retried.

  • 406

    Not accepted. Any non-2xx response — or a connection/timeout failure — is treated as a failed delivery, and the webhook is retried several times over the next 24 hours.

POST winkelstraat/push-api/v2/track
Request examples 
# Headers
x-version: V2
x-api-key: string

# Payload
{
  "track_number": "1Z97W1439109104347",
  "carrier_code": "ups",
  "shipment_id": "000000284",
  "last_modified": "2024-01-26T21:46:59.000+00:00",
  "shipping_method": "United Parcel Service - UPS Standard",
  "order_id": "000000549",
  "tracking_label_url_a6": "https://m2.winkelstraat.nl/winkelstraat_shipping/track/pdf/token/MDozOkNVUktKMnoybXBpc2tuQVQvejlRb3orYjVEWFVocVF4NytmRmZwT2VhVUFXK2Y0Tkd4d3djUjlqUXRacVF2enAyNGtYRnQ3MkNCeHBDSXhPK3dsRXRvSVBXLzRFTnNaMW5PVElyMnYvQ3hwNzJSTWlBLzR1dkVkZXkzWT0/",
  "tracking_label_url_orig": "https://m2.winkelstraat.nl/winkelstraat_shipping/track/label/token/MDozOkZXZVFwTU5JN2x4RmVxRmZsamVhWTlTaHNxRWgvQXVWajFtckdEOVRIUjdOb0N1dG1vL2l1emdVTTdtWXZKc2tpMWxOakIyMHo5MlBmclM4bm94clljR1NXUzNacmcwZndBPT0/",
  "tracking_url": "https://wwwapps.ups.com/WebTracking/processInputRequest?loc=nl_NL&tracknum=1Z97W1439109104347",
  "track_id": "koY"
}
Response examples (200) 
{}