linktree-webhooks-events
Review an approved Linktree partner event mechanism or choose a documented export and polling alternative without inventing webhooks. Use when synchronizing Linktree changes or analytics. Trigger with "review Linktree events".
Allowed Tools
Provided by Plugin
linktree-pack
Production-grade Linktree operator workflows grounded in public Help Center guidance; partner automation remains contract-gated (18 skills)
Installation
This skill is included in the linktree-pack plugin:
/plugin install linktree-pack@claude-code-plugins-plus
Click to copy
Instructions
Linktree Partner Event Contract Review
Overview
Establish whether an authorized event contract actually exists, then design validation, replay, ordering, reconciliation, and fallback from evidence rather than generic webhook conventions.
Prerequisites
- An authorized Linktree account or a clearly bounded design-only task
- The profile, Workspace, destination, campaign, data, or integration owner appropriate to the requested change
- Current account evidence for plan-dependent features and user-supplied approved partner documentation for every private interface
Tool Discipline
Use Read, Glob, and Grep to inspect repository specifications, sanitized fixtures, policies, tests, and prior receipts.
Use WebFetch only for current official Linktree documentation or explicitly approved partner documentation.
Use Write or Edit only after confirming scope, target, owners, data classification, and approval state. These tools do not confer Linktree access, account authority, or permission to process visitor data. Return exact operator steps or an approval-gated handoff when a live action is not authorized.
Current Contract
- The public developer page announces program-gated APIs and SDKs but publishes no general event catalog or verification scheme.
- Linktree documents on-screen Insights and plan-dependent CSV exports as public data-access paths.
- Event delivery details are private-contract facts and must not be inferred from another provider.
Authentication
For Admin work, use only the operator's individually provisioned Linktree account, documented Workspace role, and enabled MFA. Never request passwords, one-time codes, browser cookies, recovery codes, or session material. For partner automation, use only the authentication method, environment, scope, storage, rotation, and revocation process in the user-supplied approved partner contract. Public help pages do not establish a general API credential.
Instructions
- Name the synchronization objective, data owner, consumer, freshness requirement, data classification, and reconciliation authority.
- Use Read, Glob, and Grep to inspect the supplied partner contract, event fixtures, consumer code, and export workflow without reading secrets.
- If an approved event mechanism exists, build an evidence table for event names, schema revision, authentication, replay protection, ordering, retries, retention, and acknowledgment behavior.
- If it does not exist, choose the least-privileged documented alternative: operator review, authorized Insights CSV, or a contract-approved polling operation.
- Test synthetic duplicates, out-of-order delivery, unknown fields, stale exports, consumer failure, and reconciliation.
- Use Write or Edit to record the design and fixtures only after authority and retention are clear.
- Use WebFetch only for official public export guidance or approved partner documentation.
Approval Boundaries
Do not expose a receiver, accept live deliveries, or process subscriber data until authentication, consent, retention, deletion, and incident handling are approved.
Output
Return objective, documented mechanism, contract revision, authentication evidence, event or export schema, failure tests, reconciliation path, data controls, and go/no-go.
Error Handling
| Condition | Response |
|---|---|
| Event verification is undocumented | Do not deploy a receiver; obtain the partner contract or use a documented alternative. |
| Export contains unnecessary personal data | Minimize fields and storage before processing. |
| Consumer cannot reconcile duplicates | Add idempotency and a bounded replay test before launch. |
Example
The example is a synthetic, redacted operator receipt, not proof of Linktree access or a live account change.
objective=weekly-performance-sync; mechanism=authorized-CSV; personal-data=none; duplicates=tested; reconciliation=profile+window; receiver=not-deployed; result=go
Resources
- Official documentation map — dated evidence and limits for this workflow.
Read the map before acting. Recheck current account and partner-specific evidence for plan-dependent or private behavior.
Next Steps
Revalidate source dates, owner approval, target profile, and rollback readiness before repeating the workflow in another account, Workspace, campaign, region, plan, or integration.