# One-click Bitly import

Source: https://developers.leonai.io/docs/guides/bitly-import/

Migrate your existing Bitly links into LeonAI in a single call. You provide a Bitly
access token; LeonAI reads your Bitly links and recreates them through the normal link
creation path — so imported links behave exactly like links you create directly.
Requires `links:write`. Available on **all tiers** (imports respect your plan's link
limit).

The import is **idempotent**: re-running it skips links that already exist, so it's safe
to retry.

## Preview first with a dry run

Always start with `dryRun: true` to see what _would_ be imported without writing
anything:

```bash
curl -X POST https://api.short.leonai.io/api/v1/imports/bitly \
  -H "X-API-Key: $LEONAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accessToken": "<your-bitly-access-token>",
    "dryRun": true
  }'
```

Response (`200 OK`):

```json
{
  "success": true,
  "data": {
    "imported": 128,
    "skipped": 12,
    "failed": 2,
    "limitReached": false,
    "dryRun": true,
    "sampleErrors": [{ "shortUrl": "bit.ly/xxxx", "reason": "Invalid destination URL" }]
  }
}
```

| Field          | Meaning                                                              |
| -------------- | -------------------------------------------------------------------- |
| `imported`     | Links created (or that would be created, in a dry run)               |
| `skipped`      | Links skipped because they already exist (idempotency)               |
| `failed`       | Links that could not be imported                                     |
| `limitReached` | `true` if your tier's link limit stopped the import partway          |
| `dryRun`       | Echoes whether this was a preview                                    |
| `sampleErrors` | A sample of `{ shortUrl, reason }` for failures, for troubleshooting |

## Run the real import

Once the preview looks right, drop `dryRun` (or set it to `false`):

```bash
curl -X POST https://api.short.leonai.io/api/v1/imports/bitly \
  -H "X-API-Key: $LEONAI_API_KEY" -H "Content-Type: application/json" \
  -d '{ "accessToken": "<your-bitly-access-token>" }'
```

:::note[Tier limits apply]
Because imported links count against your plan's link quota, a large library can hit the
limit. When it does, the import stops and returns `limitReached: true` with the number
`imported` so far — [upgrade](https://developers.leonai.io/docs/guides/billing/) and re-run (already-imported links
are skipped).
:::

## Error codes

| Status | When                                                           |
| ------ | -------------------------------------------------------------- |
| `400`  | Missing or malformed `accessToken`                             |
| `429`  | Rate limit exceeded (yours or Bitly's) — retry after a backoff |
| `502`  | Bitly could not be reached or returned an error                |

## Related

- [Links](https://developers.leonai.io/docs/guides/links/) — bulk import from JSON/CSV as an alternative
- [Billing](https://developers.leonai.io/docs/guides/billing/) — plan link limits
- [API Reference](https://developers.leonai.io/docs/api-reference/) — the full OpenAPI spec and Swagger UI