linktree-webhooks-events

# Linktree Webhooks & Events ## Overview Linktree emits real-time webhook events whenever links, profiles, or analytics milestones change. These events enable automations such as syncing new bio links to a CMS, triggering social media posts when a profile is updated, alerting marketing teams when traffic milestones are hit, and auditing link lifecycle changes for compliance dashboards. All payloads are JSON over HTTPS with HMAC-SHA256 signature verification to guarantee authenticity. ## Prerequisites - A registered Linktree developer app with webhook permissions enabled - Webhook endpoint URL accessible over HTTPS (TLS 1.2+) - Signing secret from the Linktree developer dashboard (`LINKTREE_WEBHOOK_SECRET`) - Express.js with `raw` body parsing enabled for signature verification ## Webhook Registration ```typescript import axios from "axios"; const res = await axios.post( "https://api.linktr.ee/v1/webhooks", { url: "https://your-app.com/webhooks/linktree", events: ["link.created", "link.updated", "link.deleted", "profile.updated", "analytics.milestone"], }, { headers: { Authorization: `Bearer ${process.env.LINKTREE_API_TOKEN}` } } ); console.log("Subscription ID:", res.data.id); ``` ## Signature Verification ```typescript import crypto from "crypto"; import { Request, Response, NextFunction } from "express"; function verifyLinktreeSignature(req: Request, res: Response, next: NextFunction) { const signature = req.headers["x-linktree-signa...