Import from another service

At creation

Send importFromUrl with POST /api/agent/pages and the links found on that page are appended as link blocks after the ones you sent. The page title fills displayName if you left it empty.

{ "username": "anna-bakes", "importFromUrl": "https://linktr.ee/annabakes" }

Separately

curl -X POST https://tapmy.link/api/import/page -H "Authorization: Bearer …" \
  -H "Content-Type: application/json" -d '{ "url": "https://linktr.ee/annabakes" }'

{ "title": "Anna Bakes", "links": [ { "label": "Order", "url": "https://…" } ], "avatar": "https://…" }

Nothing is written: you get the list, decide what to keep, and send blocks with PATCH. The avatar is a URL on the other service; pass it to POST /api/upload to make it yours. 30 imports per hour per account.

Instagram

curl -X POST https://tapmy.link/api/import/instagram -H "Authorization: Bearer …" \
  -H "Content-Type: application/json" -d '{ "handle": "annabakes", "withAvatar": true }'

{ "profile": { "fullName": "Anna", "biography": "…", "externalUrl": "https://…", "followersCount": 12400 }, "avatarKey": "avatar/…avif" }

avatarKey is already a storage key — save it straight into avatar. Ten Instagram lookups per account per day; the scraper is third-party and sometimes slow (502 slow), which is worth one retry a minute later.

Errors

bad_url, blocked (the service walled us off), unreachable, nothing_found, js_only (the page renders its links client-side; add them by hand).