Base URL https://api.tolt.com
Body Parameters
You can create a click using one of these two methods:
Method 1: Using Partner and Link IDs
The ID of the partner who generated the click
The ID of the link that was clicked
Method 2: Using Tracking Parameter
The tracking parameter name (e.g., ‘ref’, ‘via’)
The value of the tracking parameter
Common Optional Parameters
Two-letter ISO country code where the click originated
Device type that generated the click (e.g., ‘desktop’, ‘mobile’, ‘tablet’)
URL of the page where the click occurred
URL of the referring page
Response
Whether the request was successful
Unique identifier for the click, uuid or prefixed with clk_
ID of the partner who generated the click
ID of the link that was clicked
Two-letter ISO country code
ISO 8601 timestamp of creation
Program ID the click belongs to
curl -X POST 'https://api.tolt.com/v1/clicks' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW",
"link_id": "lnk_dK9bzRGn46BhVgNFHD6fDgXW",
"country": "US",
"device": "desktop",
"page": "https://example.com/product",
"referrer": "https://google.com"
}'
{
"success": true,
"data": [
{
"id": "clk_dK9bzRGn46BhVgNFHD6fDgXW",
"page": "https://example.com/product",
"referrer": "https://google.com",
"device": "desktop",
"browser": null,
"country": "US",
"state": null,
"link_id": "lnk_dK9bzRGn46BhVgNFHD6fDgXW",
"organization_id": "org_JE3mfYNL9ci7sFaJazAv2"
"program_id": "prg_YRsbPDAKhWfdqJbFACheh",
"partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW",
"created_at": "2025-04-25T11:22:35.546Z",
"updated_at": "2025-04-25T11:22:35.546Z"
}
]
}
