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 your dashboard nav (once signed in).
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

Creating an account and shortening links on awsys.co is always free — no credit card required. The automated Bitly import (steps 1–3 above) is available on Pro, Builder, and Enterprise plans; trial users are excluded. If you're on the Free plan, you can still switch manually by re-creating your most important links, or upgrade any time to run the automated import.

• 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.