---
description: >-
  This document will go over receiving Short URL click messages notifications
  via our API.
---

# Short URL Click Notification

When a recipient clicks on a URL thas has been shortened by the system, a notification will be **POSTed** to the specified webhook URL.

### Headers

| Header       | Value            |
| ------------ | ---------------- |
| Content-Type | application/json |

### Arguments

<table><thead><tr><th>Name</th><th width="131">Type</th><th>Description</th></tr></thead><tbody><tr><td>messageId</td><td>string</td><td>Incoming Message Id</td></tr><tr><td>mobile</td><td>string</td><td>Message Originator - The mobile which sent the message..</td></tr><tr><td>batchId</td><td>string</td><td>Message Recipient - The virtual number or shortcode that received the message.</td></tr><tr><td>clientRef</td><td>string</td><td>Message reference as set by the client.</td></tr><tr><td>browser</td><td>string</td><td>Device browser.</td></tr><tr><td>country</td><td>string</td><td>Detected country based on IP Address.</td></tr><tr><td>ipAddress</td><td>string</td><td>IP address of the device.</td></tr><tr><td>iso2l</td><td>string</td><td>Two letter country ISO code (e.g. UK).</td></tr><tr><td>os</td><td>string</td><td>Device operating system.</td></tr><tr><td>url</td><td>string</td><td>The original (long) URL.</td></tr></tbody></table>

### Examples

{% tabs %}
{% tab title="Payload" %}
```json
{
   "mobile":"4400001234",
   "messageId":"9AEC3BB90A000A9D2FBD467178FF6827",
   "batchId":"9AEC3B590A000A9D2FBD4671C4D151BF",
   "clientRef":"ref-001",
   "browser":"Safari",
   "country":"United Kingdom",
   "ipAddress":"1.1.1.1",
   "iso2l":"UK",
   "os":"Mac OS X",
   "url":"http://vimeo.com/751393851?autoplay=1"
}
```
{% endtab %}
{% endtabs %}
