linktree-common-errors

# Linktree Common Errors ## Overview Linktree's API manages link-in-bio profiles, individual links, appearance settings, and analytics. Common integration errors include URL validation failures when adding links with unsupported schemes, profile-not-found errors from incorrect username lookups, and analytics data lag that causes empty responses for recently created links. Analytics data lags 15-30 minutes behind real-time, which frequently causes confusion when verifying newly created links. This reference covers HTTP errors, link management issues, and analytics-specific quirks that affect Linktree API consumers. ## Error Reference | Code | Message | Cause | Fix | |------|---------|-------|-----| | `400` | `Invalid URL format` | Link URL missing scheme or malformed | Ensure URLs include `https://` prefix and pass URL validation | | `401` | `Authentication failed` | API key invalid or expired | Regenerate key at linktr.ee developer portal | | `403` | `Plan feature restricted` | Endpoint requires Pro/Premium plan | Upgrade plan or use alternative endpoint for free tier | | `404` | `Profile not found` | Username does not exist or is deactivated | Verify username spelling; check profile is active | | `404` | `Link not found` | Link ID deleted or belongs to another profile | List links first to confirm valid IDs | | `409` | `Duplicate link` | Same URL already exists on profile | Check existing links before adding; update instead of create | | `422` | `Validation error` | Titl...