How to migrate from Bitly

Bring your existing Bitly links into awsys.co in three steps. Your Bitly account stays untouched — we only read.

1 — Generate a Generic Access Token in Bitly

1. Log in to app.bitly.com.
2. Go to Settings → API → Generic Access Token.
3. Enter your Bitly password and click Generate Token.
4. Copy the token. It looks like 0123456789abcdef… and is 32–64 hex characters long.

Security note: Treat your Generic Access Token like a password. It has full read/write access to your Bitly account. awsys.co only uses it for the duration of your import and never persists it.

2 — Start the import on awsys.co

1. Go to Migrate in the top nav.
2. Choose Bitly.
3. Paste the access token from step 1.
4. Click Preview my links — we'll fetch a summary first so you can confirm.
5. Review the count and click Start import.

3 — Use your redirect map

When the import completes (usually within a minute for small accounts), download the redirect-map.csv. Each row maps a Bitly short URL to its new awsys.co equivalent:

source_short_url,destination_short_url,long_url
https://bit.ly/abc,https://awsys.co/xyz,https://example.com/...

Use this map to update references in your CMS, marketing emails, or printed materials.

What gets imported

• Active bitlinks (long URL, title, tags, created_at)
• Lifetime click count from Bitly is recorded on each imported link as source.bitlyLifetimeClicks — for free-tier Bitly accounts this field is null because Bitly restricts the click-summary endpoint to paid plans.
• Note: archived bitlinks are excluded by Bitly's API default.
• Bitly's custom-branded domains are NOT auto-recreated — you'll see them recorded in the import notes; set up custom domains separately on awsys.co.

AgentLink — agent traffic classification

Every click on your imported short links is automatically classified as agent or human. No code change required — detection runs server-side using User-Agent patterns, MCP headers, and request heuristics.

The analytics dashboard for agent traffic is included on Pro and Builder plans. Free accounts still get the classification stored on every click; upgrade at any time to view the breakdown.

Tiers + limits

• Importing requires a paid awsys.co subscription (Pro / Builder / Enterprise). Trial users excluded.
• One concurrent import per user.
• Import job + downloadable redirect map are retained for 90 days.

Troubleshooting

• "Bitly Generic Access Token must be hex" — you may have copied a Bitly OAuth token. Use the Generic Access Token at the link above.
• The job stays "fetching" for a long time — large accounts take longer because of Bitly's per-minute rate limits. We back off and retry; no action needed.
• Status is "partial" — most links imported but some failed. Open the import detail to see which.
• I need to cancel — click Cancel import on the progress page. Links already created stay; the rest are skipped.