Webhook event types
This page lists webhook events you can subscribe to in ChottuLink. Each event uses the resource.action naming pattern (lowercase, dot-separated).
Overview
Events are grouped by the primary resource or domain they relate to:
- Links — Short-link lifecycle and clicks (
link.*). - Customers & conversions — Profiles, leads, and attributed conversions (
customer.*,lead.*,conversion.*). - App — Mobile app attribution (
app.*).
Every delivery shares the same envelope:
| Field | Type | Description |
|---|---|---|
| eventId | string | Unique id for this webhook delivery. |
| eventType | string | One of the event names below. |
| timestamp | string | Time the event was emitted (ISO-8601-style string as emitted by ChottuLink). |
| schemaVersion | number | Envelope/payload schema version (currently 1). |
| payload | object | Event-specific data. Detailed in each linked document. |
{
"eventId": "uuid",
"timestamp": "ISO-8601 string",
"schemaVersion": 1,
"eventType": "<resource.action>",
"payload": {}
}
Links
| Event | Description |
|---|---|
link.created | Triggered when a new short link is created. |
link.clicked | Triggered when a short link is clicked and the click is recorded. |
Customers & conversions
| Event | Description |
|---|---|
customer.created | Triggered when a new customer profile is created. |
lead.created | Triggered when a lead is created (for example signup). |
conversion.created | Triggered when a conversion is recorded (for example purchase). |
App
| Event | Description |
|---|---|
app.installed | Triggered when an app installation is attributed to a short link. |
Future events
Additional events (for example link.updated, link.deleted) may be added as the product evolves. They will appear here with full payload documentation once schemas and samples are finalized.