Start with a workspace and a link to an HTTPS destination. Open it in a browser, inspect the click, then connect a server-verified signup using the signed token from the destination URL.
Before you begin.
- A LinkRunway deployment and account
- An HTTPS destination you control
- A server integration for verified conversions
Create a place for your links.
Open Start for free, create an account, and name your workspace. Keep each client or business in its own workspace.
- Choose a name your team recognizes.
- Open Settings to review the attribution model and lookback window.
- Create a server key in Integrations and save it in your backend’s secret manager.
Make your first connection.
Open Links → Create link. Start with the destination and add only the context you need.
- Enter a title and an HTTPS destination.
- Set a source and campaign, such as newsletter and launch-october.
- Save, copy the short URL, and open it in a real browser.
Follow it to a signup.
An eligible redirect adds lr_token to the destination URL. Pass that token to your authenticated backend at signup. Report the signup once, using the customer ID from your own session.
curl "$LINKRUNWAY_API/v1/track" \
-H "Authorization: Bearer $LINKRUNWAY_SERVER_KEY" \
-H 'Content-Type: application/json' \
-d '{
"eventId": "signup_unique_123",
"type": "SIGNUP",
"externalUserId": "customer_123",
"clickToken": "SIGNED_CLICK_TOKEN",
"consent": true
}'See the result.
Open Events and find your signup ID. Review its attribution, then open Analytics to inspect the funnel. A test in your own workspace is real workspace activity; use a dedicated test workspace when you want to keep it separate.
- Repeat the same signup request: it should return duplicate: true.
- Open the destination on mobile and desktop.
- Test expiry and privacy signals before publishing a campaign.
Find the missing connection.
401 from the API
Check the Bearer header, key scope, and whether the key was revoked.
The event exists but is unattributed
Check token validity, consent, click eligibility, event time, and the workspace lookback window.
The custom domain does not resolve
Verify DNS ownership and configure routing and HTTPS with your hosting provider.
Reviewed October 10, 2026 · LinkRunway documentation
