An endpoint you control
Every request carries your project key in linkrunner-key, so use your own server, not a relay.
Receive campaign context as a JSON POST when an install is attributed or a user signs up. Join the events in your own systems without polling for each conversion.
Install and signup webhooks are live on every plan, including Free. Webhooks for other events are built on request.
Requests to your endpoint
POSTsignup webhook
Add it under Settings, Data Export, Webhooks, then press Test Webhook.
Install fires on attribution, signup fires on signup(), and both carry the same lr_install_id.

install webhook
signup webhook
Your users table
Paste a hooks.slack.com URL to get each install or signup with campaign, network and location.

# installs
Linkrunner9:41 AM
New install
Linkrunner9:44 AM
New signup
Retries come 1 second after the first failure and 2 seconds after the second, from two static IPs.

Your endpoint

install webhook
signup webhook
Your users table
Every request carries your project key in linkrunner-key, so use your own server, not a relay.
Three attempts, then marked failed. Allowlist both static IPs. See the webhooks docs.
With Agent Skills, npx @linkrunner/skills add webhooks has your coding agent write this receiver.
app.post("/linkrunner-webhook", async (req, res) => {
// 1. The header carries your project key
if (req.headers["linkrunner-key"] !== process.env.LINKRUNNER_KEY) {
return res.status(401).end();
}
// 2. Answer with a direct 2xx, no redirects
res.status(200).json({ received: true });
// 3. Dedupe, then do the work
const { event_type, lr_install_id, user_id } = req.body;
const key = [event_type, lr_install_id, user_id].join(":");
if (await seen(key)) return;
await queue.push(req.body);
});2
3
2
“The level of customisation that Linkrunner was able to offer was unmatched by any of the other competitors we looked at. Their team took the time to understand our exact requirements and delivered a solution that felt tailored to our needs, rather than forcing us into a fixed framework. That flexibility made a significant difference for us and was one of the key reasons Linkrunner stood out.”

Ronald M Thomas
Digital Marketing, Playo

34%
CPI reduction in 3 months
₹20.30 → ₹13.39
Google Ads CPI drop (Dec '25 → Feb '26)
Events, security and delivery, answered.
Add your final endpoint URL in Linkrunner, send a test webhook and check your receiver before processing live events.