Links
Create Link
tolt.js
Guides / How To
Customers
Clicks
Commissions
Transactions
Links
Create Link
This endpoint creates a tracking link.
POST
/
v1
/
links
curl -X POST 'https://api.tolt.com/v1/links' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"param": "ref",
"value": "michael_scott",
"partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW"
}'
{
"success": true,
"data": [
{
"id": "lnk_dK9bzRGn46BhVgNFHD6fDgXW",
"param": "ref",
"value": "michael_scott",
"partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW",
"created_at": "2025-01-15T14:30:00.000Z",
"updated_at": "2025-01-15T14:30:00.000Z",
"program_id": "prg_YRsbPDAKhWfdqJbFACheh",
"organization_id": "org_JE3mfYNL9ci7sFaJazAv2"
}
]
}
Base URL https://api.tolt.com
Body Parameters
The tracking parameter name (e.g., ‘ref’, ‘via’)
The value of the tracking parameter
The ID of the partner who owns this link
Response
Whether the request was successful
Unique identifier for the link, prefixed with lnk_
Tracking parameter name
Tracking parameter value
ID of the partner who owns the link
ISO 8601 timestamp of creation
ISO 8601 timestamp of update
Program ID the link belongs to
Organization ID
curl -X POST 'https://api.tolt.com/v1/links' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"param": "ref",
"value": "michael_scott",
"partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW"
}'
{
"success": true,
"data": [
{
"id": "lnk_dK9bzRGn46BhVgNFHD6fDgXW",
"param": "ref",
"value": "michael_scott",
"partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW",
"created_at": "2025-01-15T14:30:00.000Z",
"updated_at": "2025-01-15T14:30:00.000Z",
"program_id": "prg_YRsbPDAKhWfdqJbFACheh",
"organization_id": "org_JE3mfYNL9ci7sFaJazAv2"
}
]
}
curl -X POST 'https://api.tolt.com/v1/links' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"param": "ref",
"value": "michael_scott",
"partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW"
}'
{
"success": true,
"data": [
{
"id": "lnk_dK9bzRGn46BhVgNFHD6fDgXW",
"param": "ref",
"value": "michael_scott",
"partner_id": "part_s7mbzRGn46BhVgNFHD6fDgXW",
"created_at": "2025-01-15T14:30:00.000Z",
"updated_at": "2025-01-15T14:30:00.000Z",
"program_id": "prg_YRsbPDAKhWfdqJbFACheh",
"organization_id": "org_JE3mfYNL9ci7sFaJazAv2"
}
]
}