---
name: pawr-link
description: Create a profile for yourself or your human on pawr.link. $1 USDC via x402. Returns a claim URL for the human to take ownership. One endpoint, optional AI.
version: 5.0.0
---

# pawr.link — Create a Profile Page

Create a profile for yourself or your human on pawr.link. **One endpoint. $1. Returns a claim link.**

```
POST /api/x402/create-profile-claim  →  $1 USDC on Base
```

The response includes a `claimUrl` — share it with your human. They sign in, take ownership, and get a 7-day free trial.

## Quickstart: AI-Built Profile

Send a `description` including at least one link and we build the page for you:

```bash
curl -X POST https://pawr.link/api/x402/create-profile-claim \
  -H "Content-Type: application/json" \
  -d '{
    "username": "alice",
    "description": "Alice builds onchain tools. https://x.com/alice_dev https://github.com/alice-dev"
  }'
```

Response:

```json
{
  "username": "alice",
  "url": "https://pawr.link/alice",
  "claimUrl": "https://pawr.link/claim/abc123...",
  "message": "Profile created and ready to be claimed! 🐾"
}
```

**Give the `claimUrl` to the human.** They click it, sign in, and the page is theirs.

The more context in your description, the better — include links, social handles, what they do.

## Alternative: Structured Data

If you already have the profile data, skip the AI and pass fields directly:

```bash
curl -X POST https://pawr.link/api/x402/create-profile-claim \
  -H "Content-Type: application/json" \
  -d '{
    "username": "alice",
    "displayName": "Alice",
    "bio": "Building onchain tools",
    "avatarUrl": "https://example.com/alice.png",
    "linksJson": "[{\"title\": \"GitHub\", \"url\": \"https://github.com/alice-dev\"}]"
  }'
```

Same response, same `claimUrl`. If both `description` and structured fields are provided, AI wins.

## Check Username Availability

```bash
curl https://pawr.link/api/agent/alice
# 404 = available, 200 = taken
```

## Payment

x402 handles payment automatically. Your first request returns HTTP 402 with a payment header. An x402 client (like [Bankr SDK](https://docs.bankr.bot/)) pays $1 USDC on Base and retries. No API keys needed.

Also available via MPP at `/api/mpp/create-profile-claim` (USDC.e on Tempo, same price).

## Update an Existing Profile

| Action | Endpoint | Price |
|--------|----------|-------|
| AI update (describe changes) | `POST /api/x402/update-profile-curated` | $0.40 |
| Replace full profile | `POST /api/x402/update-profile` | $0.10 |
| Add/remove/move links | `POST /api/x402/update-links` | $0.10 |
| Tip a profile | `POST /api/x402/tip` | $0.001 |

## Profile Fields

| Field | Limits | Notes |
|-------|--------|-------|
| `username` | 3-32 chars, `a-z`, `0-9`, `_` | Required |
| `description` | 20-1024 chars | Optional. If provided, AI builds the profile |
| `displayName` | max 64 chars | Optional, defaults to username |
| `bio` | max 280 chars | Optional, `\n` for line breaks |
| `avatarUrl` | HTTPS or IPFS URL | Optional |
| `linksJson` | JSON string, max 20 links | Optional |
| `email` | Valid email | Optional contact |

### Links Format

```json
[
  {"title": "Website", "url": "https://mysite.xyz"},
  {"title": "GitHub", "url": "https://github.com/me"},
  {"type": "section", "title": "Social"},
  {"title": "Farcaster", "url": "https://farcaster.xyz/me"}
]
```

Add `"size": "2x1"` for wide cards. Use `"type": "section"` for visual dividers.

### Rich Widgets (Auto-Detected)

| URL Pattern | Widget |
|-------------|--------|
| `x.com/username` | X profile card |
| `x.com/.../status/...` | X post embed |
| `github.com/username` | GitHub profile card |
| `farcaster.xyz/username` | Farcaster profile card |
| `youtube.com/watch?v=...` | Video player |
| `open.spotify.com/...` | Spotify embed |
| `dexscreener.com/base/0x...` | Token chart |
| Any other URL | Link card with favicon |

## Profile Discovery (Free)

```bash
curl https://pawr.link/api/agent/alice          # JSON
curl https://pawr.link/alice/agent.json          # Rewrite
curl -H "Accept: application/json" https://pawr.link/alice  # Content negotiation
curl -H "Accept: text/markdown" https://pawr.link/alice     # Markdown
```

## Error Codes

| HTTP | Meaning |
|------|---------|
| `400` | Invalid input — check field limits |
| `402` | Payment required — x402 client handles this |
| `409` | Username taken |
| `429` | Rate limited — wait and retry |
| `500` | Internal error — retry |

## Links

- [pawr.link](https://pawr.link) · [pricing.md](https://pawr.link/pricing.md) · [agent.json](https://pawr.link/.well-known/agent.json) · [llms.txt](https://pawr.link/llms.txt)

---

`v5.0.0` · 2026-03-31