---
updatedAt: 2025-06-13T11:52:47.000Z
agentTools:
  projectIndex: https://developers.bringg.com/llms.txt
---

# Customer Tipped Driver

The *Customer Tipped Driver* callback occurs when a customer tips a user (driver).This callback returns  detailed information describing tip (gratuity), user (driver), and the customer.

> 📘 Register Your URL for this Webhook
>
> To start receiving webhooks from Bringg, you must first register a URL. Detailed guidance on setting up and managing Bringg webhooks is available in the following resources:
>
> * [Send Bringg Webhooks](https://developers.bringg.com/docs/bringg-webhooks): Subscribe to webhooks and customize the fields in your callbacks.
> * [Webhook Authentication Methods](https://developers.bringg.com/docs/webhook-authentication-methods): Ensure that your other systems recognize and accept webhooks from Bringg.

<br />

## Response

```json
{
	"user": {
		"id": 77484,
		"name": "Ben Willington",
		"status": "online",
		"sub": "Assigned",
		"lat": 32.0940105,
		"lng": 34.8282588,
		"phone": "",
		"merchant_id": 11271,
		"profile_image": "/images/avatar.png",
		"admin": false,
		"dispatcher": false,
		"beta": false,
		"email": "ben.willington@mycompany.com",
		"job_description": "",
		"external_id": "77484",
		"company": "",
		"active_shift_id": 1673508,
		"driver_current_sign_in_at": "2017-12-25T13:39:39.000Z",
		"driver_sign_in_count": 3,
		"uuid": "ae56748d-8f9a-4892-bb8e-67150382fb82",
		"battery": 0,
		"average_rating": 0,
		"driver": true,
		"estimated_last_etl": "2017-12-25T15:56:20.000Z",
		"estimated_last_lat": 32.0917476,
		"estimated_last_lng": 34.8321991,
		"estimated_last_address": "River Rd 100, Tel Aviv, Israel",
		"at_home": false,
		"team_ids": [
      19587
    ],
		"user_type_id": null,
		"vehicle_type_id": null,
		"language": "",
		"default_user_activity": "5",
		"authorization_flags": {},
		"private_vehicle": true,
		"in_beacon_range": false
	},
	"task": {
		"id": 8922584,
		"external_id": "8922584"
	},
	"note": {
    "id": 59128696,
    "note": null,
    "user_id": 103797,
    "task_id": 68635918,
    "created_at": "2020-01-09T16:12:05.982Z",
    "updated_at": "2020-01-09T16:12:05.982Z",
    "type": "Signature",
    "url": "https://task-images-prod-us1.s3.amazonaws.com/uploads/signature/url/123456/xxxxxxxxxxxxx",
    "way_point_id": 86834871,
    "customer_id": null,
    "lat": 32.1068092,
    "lng": 34.8346162,
    "task_inventory_id": null,
    "external_id": "59128696",
    "tip": 4.9
	}
}
```

## Output Params

The *Customer Tipped Driver* callback returns a JSON containing three JSONs. These three JSONs are:

* user
* task
* note

> 📘
>
> The three *Customer Tipper Driver* JSONs are describe separately below.

## user

<HTMLBlock>{`
<div>
	<table class="param_table">
      <tr>
        <td>
          <p class="param_name">id</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">The Id of this user (driver).</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">active_shift_id</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">The Id of the user's (driver's) current shift.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">admin</p>
          <p class="param_type">boolean</p>
        </td>
        <td>
          <p class="param_desc">Indicates whether this user (driver) is a Bringg administrator. The values are:</p>
          <ul class="param_desc">
            <li>
            <span class="value">false</span> or 
            <span class="value">0</span> - the user (driver) is not an administrator</li>
            <li>
            <span class="value">true</span> or 
            <span class="value">1</span> - the user (driver) is an administrator</li>
          </ul>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">at_home</p>
          <p class="param_type">boolean</p>
        </td>
        <td>
          <p class="param_desc">Indicates whether the user (driver) is at home.</p>
          <ul class="param_desc">
            <li>
            <span class="value">false</span> or 
            <span class="value">0</span> - the user (driver) is not at home</li>
            <li>
            <span class="value">true</span> or 
            <span class="value">1</span> - the user (driver) is at home</li>
          </ul>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">authorization_flags</p>
          <p class="param_type">JSON</p>
        </td>
        <td>
          <p class="param_desc">A JSON containing user (driver) privileges.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">average_rating</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">The user's (driver's) average rating.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">battery</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">The user's (driver's) current battery.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">beta</p>
          <p class="param_type">boolean</p>
        </td>
        <td>
          <p class="param_type">Indicates whether the user (driver) is a beta.</p>
          <ul class="param_desc">
            <li>
            <span class="value">false</span> or 
            <span class="value">0</span> - the user (driver) is not a beta</li>
            <li>
            <span class="value">true</span> or 
            <span class="value">1</span> - the user (driver) is a beta</li>
          </ul>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">company</p>
          <p class="param_type">string</p>
        </td>
        <td>
          <p class="param_desc">The name of the company.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">default_user_activity</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">The user's (driver's) default activity. The values are:</p>
          <ul class="param_desc">
            <li><span class="value">0</span> - unknown</li>
            <li><span class="value">1</span> - stationary</li>
            <li><span class="value">2</span> - walking</li>
            <li><span class="value">3</span> - running</li>
            <li><span class="value">4</span> - bicycle</li>
            <li><span class="value">5</span> - driving</li>
           </ul>
          <p class="param_desc">The default values is <span class="value">5</span>.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">dispatcher</p>
          <p class="param_type">boolean</p>
        </td>
        <td>
          <p class="param_desc">Indicates whether this user (driver) is a Bringg dispatcher. The values are:</p>
          <ul class="param_desc">
            <li>
            <span class="value">false</span> or 
            <span class="value">0</span> - the user (driver) is not an dispatcher</li>
            <li>
            <span class="value">true</span> or 
            <span class="value">1</span> - the user (driver) is an dispatcher</li>
          </ul>
          <p class="param_desc">The default value is 
          <span class="value">false</span>.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">driver</p>
          <p class="param_type">boolean</p>
        </td>
        <td>
          <p class="param_desc">Indicates whether this user (driver) is a Bringg driver. The values are:</p>
          <ul class="param_desc">
            <li>
            <span class="value">false</span> or 
            <span class="value">0</span> - the user (driver) is not an driver</li>
            <li>
            <span class="value">true</span> or 
            <span class="value">1</span> - the user (driver) is an driver</li>
          </ul>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">driver_current_sign_in_at</p>
          <p class="param_type">datetime</p>
        </td>
        <td>
          <p class="param_desc">The date and time the user (driver) signed into the current session. This is in UTC and is in the format is "<span class="emphasis">%Y-%m-%dT%H:%M:%S%z</span>".</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">driver_sign_in_count</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">The number of times the user (driver) signed into the app.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">email</p>
          <p class="param_type">string</p>
        </td>
        <td>
          <p class="param_desc">The email address of this customer. The maximum length is 255 characters.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">estimated_last_address</p>
          <p class="param_type">string</p>
        </td>
        <td>
          <p class="param_desc">The last known address of the user (driver) using approximation based on last or next delivery.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">estimated_last_etl</p>
          <p class="param_type">datetime</p>
        </td>
        <td>
          <p class="param_desc">The estimated time of leaving the last known order location (ETA plus time on site). This is in UTC and is in the
          format is "<span class="emphasis">%Y-%m-%dT%H:%M:%S%z</span>".</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">estimated_last_lat</p>
          <p class="param_type">double</p>
        </td>
        <td>
           <p class="param_desc">The last known latitude of the user (driver) using approximation based on last or next delivery.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">estimated_last_lng</p>
          <p class="param_type">double</p>
        </td>
        <td>
            <p class="param_desc">The last known longitude of the user (driver) using approximation based on last or next delivery.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">external_id</p>
          <p class="param_type">string</p>
        </td>
        <td>
          <p class="param_desc">The customer&#39;s external Id.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">in_beacon_range</p>
          <p class="param_type">boolean</p>
        </td>
        <td>
          <p class="param_desc">Indicates whether the user (driver) is in range of a known beacon.</p>
          <ul class="param_desc">
            <li>
            <span class="value">false</span> or 
            <span class="value">0</span> - the user (driver) is not in range of a beacon</li>
            <li>
            <span class="value">true</span> or 
            <span class="value">1</span> - the user (driver) is in range of a beacon</li>
          </ul>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">job_description</p>
          <p class="param_type">string</p>
        </td>
        <td>
          <p class="param_desc">The user's (driver's) job description. The maximum length is 255 characters.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">language</p>
          <p class="param_type">string</p>
        </td>
        <td>
          <p class="param_desc">The user's (driver's) language.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">lat</p>
          <p class="param_type">double</p>
        </td>
        <td>
          <p class="param_desc">The geoposition latitude of the user (driver) when the customer tipped the user (driver).</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">lng</p>
          <p class="param_type">double</p>
        </td>
        <td>
          <p class="param_desc">The geoposition longitude of the user (driver) when the customer tipped the user (driver).</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">merchant_id</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">The Id of the company. The merchant_id may be 
          <span class="value">null</span>, if the developer works with only one company.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">name</p>
          <p class="param_type">string</p>
        </td>
        <td>
          <p class="param_desc">The name of this customer. The maximum length is 255 characters.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">phone</p>
          <p class="param_type">string</p>
        </td>
        <td>
          <p class="param_desc">The phone number of this customer.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">private_vehicle</p>
          <p class="param_type">boolean</p>
        </td>
        <td>
          <p class="param_desc">Indicates whether the user (driver) uses a private vehicle</p>
          <ul class="param_desc">
            <li>
            <span class="value">false</span> or 
            <span class="value">0</span> - the user (driver) does use a private vehicle</li>
            <li>
            <span class="value">true</span> or 
            <span class="value">1</span> - the user (driver) does not use a private vehicle</li>
          </ul>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">profile_image</p>
          <p class="param_type">text</p>
        </td>
        <td>
          <p class="param_desc">The URL of a profile image associated with this customer. The default value is 
          <span class="value">null</span>.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">status</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">The user's (driver's) status. The values are:</p>
          <ul class="param_desc">
            <li><span class="value">Free</span></li>
            <li><span class="value">Assigned</span></li>
            <li><span class="value">Started</span></li>
            <li><span class="value">Checked-In</span></li>
            <li><span class="value">Late</span></li>
            </ul>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">sub</p>
          <p class="param_type">string</p>
        </td>
        <td>
          <p class="param_desc">The sub status of the user (driver). The maximum length is 255 characters.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">team_ids</p>
          <p class="param_type">Array of Int32</p>
        </td>
        <td>
          <p class="param_desc">An array of Int32 containing the Ids of all teams to which this user (driver) belongs.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">user_type_id</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">The Id of the user type.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">uuid</p>
          <p class="param_type">UUID</p>
        </td>
        <td>
          <p class="param_desc">The universal unique Id of this customer.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">vehicle_type_id</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">The Id of the user's (driver's) vehicle type.</p>
        </td>
      </tr>
    </table>

</div>
`}</HTMLBlock>

## task

<HTMLBlock>{`
<div>
	<table class="param_table">
      <tr>
        <td>
          <p class="param_name">id</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">The Id of the order for which the customer tipped the user (driver).</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">external_id</p>
          <p class="param_type">string</p>
        </td>
        <td>
          <p class="param_desc">The external Id of the order.</p>
        </td>
      </tr>
    </table>

</div>
`}</HTMLBlock>

## note

<HTMLBlock>{`
<div>
	<table class="param_table">
      <tr>
        <td>
          <p class="param_name">id</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">The Id of the note for this tip (gratuity) paid by this customer to this user (driver).</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">lat</p>
          <p class="param_type">double</p>
        </td>
        <td>
          <p class="param_desc">The geolocation latitude of the user (driver) when the customer tipped the user (driver).</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">lng</p>
          <p class="param_type">double</p>
        </td>
        <td>
          <p class="param_desc">The geolocation longitude of the user (driver) when the customer tipped the user (driver).</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">note</p>
          <p class="param_type">string</p>
        </td>
        <td>
          <p class="param_desc">A note indicating the user (driver) tip and the amount.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">task_id</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">If this order was created from another order (for example, a failed order), this is the Id of that
          original order.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">tip</p>
          <p class="param_type">double</p>
        </td>
        <td>
          <p class="param_desc">The tip (gratuity) paid by this customer to this user (driver).</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">type</p>
          <p class="param_type">string</p>
        </td>
        <td>
          <p class="param_desc">The type of the note. The value is TipSignature.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">url</p>
          <p class="param_type">text</p>
        </td>
        <td>
          <p class="param_desc">The URL added in this note.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p class="param_name">way_point_id</p>
          <p class="param_type">Int32</p>
        </td>
        <td>
          <p class="param_desc">The Id of the way point location of this customer who tipped the user (driver).</p>
        </td>
      </tr>
    </table>

</div>
`}</HTMLBlock>