Skip to main content
POST
https://api.tolt.com
/
v1
/
clicks
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"
    }
  ]
}

​
Base URL https://api.tolt.com


​
Body Parameters

You can create a click using one of these two methods:
​
partner_id*
string
The ID of the partner who generated the click
​
link_id
string - optional
The ID of the link that was clicked

​
Method 2: Using Tracking Parameter

​
param*
string
The tracking parameter name (e.g., ‘ref’, ‘via’)
​
value*
string
The value of the tracking parameter

​
Common Optional Parameters

​
country
string - optional
Two-letter ISO country code where the click originated
​
device
string - optional
Device type that generated the click (e.g., ‘desktop’, ‘mobile’, ‘tablet’)
​
page
string - optional
URL of the page where the click occurred
​
referrer
string - optional
URL of the referring page

​
Response

​
success
boolean
Whether the request was successful
​
data
object
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"
    }
  ]
}