---
name: linktree-hello-world
description: 'Create a minimal working Linktree example.

  Trigger: "linktree hello world", "linktree example", "test linktree".

  '
allowed-tools: Read, Write, Edit, Bash(npm:*), Grep
version: 1.0.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
tags:
- saas
- linktree
- social
compatibility: Designed for Claude Code
---
# Linktree Hello World

## Overview

Minimal working examples demonstrating core Linktree API functionality.

## Instructions

### Step 1: Get Profile

```typescript
const profile = await client.profiles.get('myprofile');
console.log(`Bio: ${profile.bio}`);
console.log(`Links: ${profile.links.length}`);
```

### Step 2: Create a Link

```typescript
const link = await client.links.create({
  profile_id: profile.id,
  title: 'My Website',
  url: 'https://example.com',
  position: 0,  // Top of list
  thumbnail: 'https://example.com/icon.png'
});
console.log(`Created link: ${link.id}`);
```

### Step 3: Update Link

```typescript
await client.links.update(link.id, {
  title: 'Updated Title',
  archived: false
});
```

### Step 4: List All Links

```typescript
const links = await client.links.list({ profile_id: profile.id });
links.forEach(l => console.log(`${l.position}: ${l.title} → ${l.url}`));
```

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| Auth error | Invalid credentials | Check LINKTREE_API_KEY |
| Not found | Invalid endpoint | Verify API URL |
| Rate limit | Too many requests | Implement backoff |

## Resources

- [Linktree API Docs](https://linktr.ee/marketplace/developer)

## Next Steps

See `linktree-local-dev-loop`.
