> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Bitly

**Authentication:** OAuth or access token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* Generate a short link for this URL with UTM tags for our LinkedIn campaign.
* Pull click counts for every link tagged `Q2-launch` and rank them by total clicks.
* List the top 10 short links by click-through this week.

## Available Tools

#### shorten_bitlink

Shorten a long URL to a Bitlink. Simplest way to create a short link. Returns the new short URL.

#### create_bitlink

Create a Bitlink with full options including title, tags, and deeplinks. Use shorten_bitlink for simple URL shortening.

#### get_bitlink

Get details of a Bitlink by its ID (e.g., 'bit.ly/abc123'). Returns title, long URL, tags, and metadata.

#### update_bitlink

Update a Bitlink's title, tags, long URL, or archived status. Use get_bitlink to verify the bitlink exists.

#### delete_bitlink

Delete a Bitlink permanently. This cannot be undone. Use get_bitlink to verify before deleting.

#### expand_bitlink

Expand a short Bitlink to its original long URL. Provide the bitlink ID (e.g., 'bit.ly/abc123').

#### list_bsds

List all branded short domains (BSDs) available to the current user.

#### list_channels

List channels in a group. Channels are distribution methods for campaigns. Use list_groups to find valid group GUIDs.

#### list_groups

List all groups the current user belongs to. Returns group GUIDs needed for other operations.

#### get_group

Get details of a specific Bitly group. Use list_groups to find valid GUIDs.

#### update_group

Update a Bitly group's name or settings. Use list_groups to find valid GUIDs.

#### list_group_bitlinks

List bitlinks in a group with optional filters. Supports pagination via search_after cursor. Use list_groups to find ...

#### get_group_tags

Get all tags used in a group. Use list_groups to find valid GUIDs.

#### get_group_preferences

Get preferences for a group including default domain. Use list_groups to find valid GUIDs.

#### update_group_preferences

Update group preferences such as default domain. Use list_groups to find valid GUIDs.

#### list_organizations

List all organizations the current user belongs to.

#### get_organization

Get details of a specific Bitly organization by GUID. Use list_organizations to find valid GUIDs.

#### get_organization_plan_limits

Get plan limits for an organization. Use list_organizations to find valid GUIDs.

#### get_current_user

Get the current authenticated Bitly user's profile including name, email, and default group.

#### get_platform_limits

Get platform rate limits for the current Bitly user.