Set-Click Endpoint

Overview

The Set-Click endpoint allows you to record conversion events associated with user clicks.
This is especially useful for:

• offline conversions,
• phone-call conversions,
• CRM-based conversions,
• or any action triggered outside your main website but originating from online marketing.

---

Endpoint Details

• URL: https://app.sealmetrics.com/api/auth/v1.0/set-click
• Method: POST
• Authentication: Bearer Token required
• Content-Type: application/x-www-form-urlencoded

---

Request Parameters

Headers

Header	Value	Required
Authorization	Bearer {your_access_token}	Yes
Content-Type	application/x-www-form-urlencoded	Yes
Accept	application/json	Yes

---

Body Parameters

Parameter	Type	Required	Description
account_id	string	Yes	Must match your client_id
url_parameters	object	Yes	JSON object containing UTM parameters
click_time	number	Yes	Unix timestamp (ms)
settings	object	Yes	JSON object with extra settings (e.g. email)
referrer	string	No	Referrer URL
current_url	string	No	Current URL

---

Example Requests

cURL

curl --location 'https://app.sealmetrics.com/api/auth/v1.0/set-click' --header 'Authorization: Bearer YOUR_TOKEN_HERE' --header 'Content-Type: application/x-www-form-urlencoded' --header 'Accept: application/json' --data-urlencode 'url_parameters={"utm_medium":"my-medium-01","utm_source":"my-source-01"}' --data-urlencode 'click_time=1634707888' --data-urlencode 'settings={"email":"david.navarro@adinton.com"}' --data-urlencode 'referrer="https://facebook.com/"' --data-urlencode 'current_url="https://sealmetrics.com/"' --data-urlencode 'account_id=60a52f6ac660b269d13c3f53'

---

Python

import requests

url = "https://app.sealmetrics.com/api/auth/v1.0/set-click"

payload = {
    'account_id': '60a52f6ac660b269d13c3f53',
    'url_parameters': '{"utm_medium":"my-medium-01","utm_source":"my-source-01"}',
    'click_time': '1634707888',
    'settings': '{"email":"david.navarro@adinton.com"}',
    'referrer': '"https://facebook.com/"',
    'current_url': '"https://sealmetrics.com/"'
}

headers = {
    'Authorization': 'Bearer YOUR_TOKEN_HERE',
    'Content-Type': 'application/x-www-form-urlencoded',
    'Accept': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

---

JavaScript

var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer YOUR_TOKEN_HERE");
myHeaders.append("Content-Type", "application/x-www-form-urlencoded");
myHeaders.append("Accept", "application/json");

var urlencoded = new URLSearchParams();
urlencoded.append("account_id", "60a52f6ac660b269d13c3f53");
urlencoded.append("url_parameters", "{"utm_medium":"my-medium-01","utm_source":"my-source-01"}");
urlencoded.append("click_time", "1634707888");
urlencoded.append("settings", "{"email":"david.navarro@adinton.com"}");
urlencoded.append("referrer", ""https://facebook.com/"");
urlencoded.append("current_url", ""https://sealmetrics.com/"");

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: urlencoded,
  redirect: 'follow'
};

fetch("https://app.sealmetrics.com/api/auth/v1.0/set-click", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

---

Response

Success Response (200 OK)

No response body

A successful request returns no JSON body.

---

Error Responses

401 Unauthorized

{
  "status": "error",
  "message": "Unauthenticated"
}

400 Bad Request

{
  "status": "error",
  "message": "Missing required parameter: account_id"
}

---

Notes

• This endpoint applies a conversion to the last click of the journey.
• The offline-leads scope must be enabled in your Adinton user account.
• account_id must match your client_id.
• url_parameters must include relevant UTMs.
• To create a microconversion, include "microconversion":"1" in the lead parameters.
• Useful for syncing offline conversions, CRM activity, or call-tracking with SealMetrics.
• All parameters must be properly URL-encoded.