Driver Location Webhook (Beta)

Shipday now offers real-time driver location updates via webhook subscription. This feature is currently in beta and available exclusively to our priority customers.

Feature Overview

• Receive real-time updates of driver locations
• Location data provided as latitude and longitude coordinates
• Webhook configuration requires internal setup by Shipday team

Subscription Requirements

Endpoint URL (mandatory):

The URL where Shipday will send location updates

Validation Token (optional):

• Max 32 characters
• Used to verify the authenticity of webhook payloads
• Sent in the webhook header as "token"

Attributes

currentTimeStamp Long Integer

Timestamp of the event.

event String

A fixed string LOCATION_UPDATE

orderId Integer

Unique identifier of the order in Shipday.

companyId Integer

Unique identifier of the company or restaurant or in general any business having account registered at Shipday.

latitude Double

Driver location latitude at that particular timestamp.

longitude Double

Driver location latitude at that particular timestamp.

Below is an example payload of location webhook.

Location Webhook payload example

  {
    "event":"LOCATION_UPDATE",
    "orderId": 12345,
    "companyId": 67890,
    "latitude": 37.7749,
    "longitude": -122.4194,
    "currentTimeStamp": 1631234567890
  }