Delivery Updated Webhook

Each time that a change / update is made from the Bringg side to the following fields, this webhook will be triggered. Bringg will send only the relevant fields changed (along with the identifying fields for the objects) UNLESS you request to receive the full Delivery Created payload:

  • Address
  • Note added
  • Inventory quantity
  • Scheduled time
  • Delivery window
  • Customer information (e.g. phone number, email address, name)

If you wish to instead receive the full Delivery Created payload, you can configure this by checking the "Get full payload update for any Delivery Update" box below the Delivery Updated webhook endpoint:

📘

What response Bringg expects from you

We need a success:true response. Nothing else in the body of the payload is required.

{
    "success": true
}

EXAMPLE PAYLOADS FROM BRINGG

{
  "task_id": 7694849,
  "delivery_id": "123",
  "way_point": {
    "address": "6307 LAKE WHEELER RD",
    "lat": 35.6959427,
    "lng": -78.69186169999999,
    "id": 11812926,
    "position": 2
  }
}
{
  "task_id": 9896721,
  "delivery_id": "ABCD1234",
  "way_point": {
    "address_second_line": "Apartment 3",
    "id": 14840469,
    "position": 2
  }
}
{
  "task_id": 7694849,
  "delivery_id": "123",
  "way_point": {
    "scheduled_at": "2020-06-30T11:00:00.000Z",
    "id": 11812925,
    "position": 1
  }
}
{
  "task_id": 7694849,
  "delivery_id": "123",
  "way_point": {
    "no_earlier_than": "2020-06-30T12:00:00.000Z",
    "no_later_than": "2020-06-30T16:00:00.000Z",
    "id": 11812925,
    "position": 1
  }
}
{
  "task_id": 9896721,
  "delivery_id": "ABCD1234",
  "way_point": {
    "phone": "+15555555556",
    "id": 14840469,
    "position": 2
  }
}
{
  "task_id": 9896721,
  "delivery_id": "ABCD1234",
  "way_point": {
    "email": "[email protected]",
    "id": 14840469,
    "position": 2
  }
}
{
  "task_id": 9896721,
  "delivery_id": "ABCD1234",
  "task_inventory": {
    "original_quantity": 3,
    "id": 37792187,
    "name": "Mild Chicken Sandwich"
  }
}
{
  "task_id": 7694849,
  "delivery_id": "123",
  "task_note": {
    "id": 10284559,
    "note": "Customer added a note",
    "user_id": 660963,
    "task_id": 7694849,
    "created_at": "2020-06-09T12:59:29.883Z",
    "updated_at": "2020-06-09T12:59:29.883Z",
    "type": "TaskNote",
    "way_point_id": 11812926,
    "external_id": "10284559"
  }
}
{
  "task_id": 11277545,
  "delivery_id": "ABCD1234",
  "way_point": {
    "scheduled_at": "2020-07-16T14:02:41.000Z",
    "name": "Name Changed",
    "id": 16672790,
    "position": 2
  }
}
{
  "task_id": 11277918,
  "delivery_id": "ABCD1234",
  "way_point": {
    "city": "Chicago",
    "scheduled_at": "2020-07-16T14:37:27.000Z",
    "id": 16673227,
    "position": 2
  }
}
{
  "task_id": 9896721,
  "delivery_id": "ABCD1234",
  "way_point": {
    "zipcode": "12345",
    "id": 14840468,
    "position": 1
  }
}
{
  "task_id": 11277918,
  "delivery_id": "ABCD1234",
  "way_point": {
    "lat": 36,
    "lng": -79,
    "id": 16673227,
    "position": 2
  }
}

BODY PARAMS

delivery_id

string

The delivery ID you provided for this order

task_id

Int32

Bringg's unique ID for this order

way_point_id

Int32

Bringg's ID for this way point. This allows you to identify which way point was updated.

position

Int32

The way point or stop number. Possible values are 1 for pickup and 2 for dropoff.

no_earlier_than

datetime

The date and time of the beginning of the delivery time window. This is in UTC in the format "%Y-%m-%dT%H:%M:%S%z"

no_later_than

datetime

The date and time of the end of the delivery time window. This is in UTC in the format "%Y-%m-%dT%H:%M:%S%z"

scheduled_at

datetime

The date and time the order is scheduled for. This is in UTC in the format "%Y-%m-%dT%H:%M:%S%z"

address

string

Address of the way point

original_quantity

Int32

The quantity of inventory items to be picked up or delivered