Webhooks

Webhooks allow you to receive real-time notifications when your links are clicked. When a click occurs, Linkly sends a POST request to your specified URL(s) with detailed information about the click.

• Automation Platforms: Trigger workflows in Make.com or Zapier when links are clicked
• Custom Analytics: Send click data to your own analytics system
• CRM Updates: Update customer records when they click links
• Slack Notifications: Get notified in Slack when important links are clicked
• Lead Tracking: Track when prospects engage with your links

Tip: For most automation use cases, our Make.com integration or Zapier integration are easier to set up than custom webhooks. They include instant click triggers powered by webhooks, with no coding required.

Note: If you configure webhooks at both levels, both will fire for clicks on that link.

When a click occurs, Linkly sends a POST request with the following JSON payload:

{
  "event": "click",
  "timestamp": "2025-01-15T10:30:00Z",
  "link": {
    "id": 12345,
    "name": "My Campaign Link",
    "url": "https://example.com/landing-page",
    "full_url": "https://yourdomain.com/abc123",
    "domain": "yourdomain.com",
    "slug": "/abc123",
    "destination": "https://example.com/landing-page",
    "workspace_id": 1,
    "enabled": true,
    "cloaking": false,
    "forward_params": true,
    "block_bots": true,
    "public_analytics": false,
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "spring-sale",
    "og_title": "Special Offer",
    "og_description": "Check out our spring sale!",
    "rules": [
      {
        "what": "country",
        "matches": "US",
        "url": "https://example.com/us-landing"
      }
    ]
  },
  "click": {
    "country": "US",
    "is_eu_country": false,
    "platform": "desktop",
    "browser_name": "Chrome",
    "referer": "https://twitter.com/",
    "isp": "Comcast",
    "bot_name": null,
    "destination": "https://example.com/landing-page",
    "params": {
      "utm_source": "twitter"
    }
  }
}

Privacy Note: IP addresses are never included in webhook payloads.

For easier setup without custom coding, use our native integrations:

• Make.com Integration - Visual automation platform with instant click triggers
• Zapier Integration - Connect Linkly to thousands of apps with no code

Both integrations use webhooks under the hood but handle all the setup automatically.

You can add multiple webhook URLs (one per line). All URLs will receive the same payload when a click occurs.

• Webhooks are fire-and-forget - Linkly does not retry failed deliveries
• Webhook failures never affect the redirect - users always reach their destination
• Ensure your webhook endpoint responds quickly (< 5 seconds recommended)

• Use HTTPS endpoints for webhook URLs
• Validate incoming requests in your webhook handler
• Consider adding a secret parameter to your webhook URL for verification

1. 1Set up a webhook URL using a service like webhook.site or RequestBin
2. 2Click your link
3. 3Inspect the received payload
4. 4Once verified, switch to your production webhook URL

You can also manage webhooks programmatically via the API:

POST   /api/v1/link/:link_id/webhooks
DELETE /api/v1/link/:link_id/webhooks/:hook_id
GET    /api/v1/link/:link_id/webhooks

POST   /api/v1/workspace/:workspace_id/webhooks
DELETE /api/v1/workspace/:workspace_id/webhooks/:hook_id
GET    /api/v1/workspace/:workspace_id/webhooks

See the API Documentation for details.