inbound. link. wrap
Create a short link and track clicks by campaign, channel, or contact without cookies.
0 credits. Free: part of a publish.
Example prompt
Send this to your AI app when Heelo is connected:
Wrap https://example.com/pricing for the email channel in campaign seq_2026q4
Input fields
| Field | Type | Description |
|---|---|---|
target_urlRequired | string | The destination URL to wrap |
campaign | string | Campaign id, e.g. 'seq_2026q4' |
channel | string | Channel, e.g. 'email' | 'bluesky' |
contact_id | string | Contact to attribute the click to |
reuse_existing | boolean | When true, return the first short link already made for the same target_url, campaign, channel and contact_id instead of creating a new one. Default false: every call makes a new code. |
Output fields
The fields in data when status is success.
| Field | Type |
|---|---|
short_url | string |
code | string |
reused | boolean |
answer | string |
Code
The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.
import os
import requests
response = requests.post(
"https://toolsprimitives.uk/v1/tools/inbound.link.wrap/invoke",
headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
json={"input": {
"target_url": "https://example.com",
}},
timeout=120,
)
response.raise_for_status()
print(response.json())// Node.js 18 or newer, in an ES module.
const response = await fetch("https://toolsprimitives.uk/v1/tools/inbound.link.wrap/invoke", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HEELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
input: {
"target_url": "https://example.com"
},
}),
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());