Add Bitly to your AI agent

Create an empty Bitly Site in a group with default appearance settings. Choose a domain and keyword for its URL. Availability and site limits depend on the connected account's Bitly plan.

Create a Bitlink, social, YouTube video, image, digital business card, or text block on a Bitly Site. Supply content matching the selected type; use parent to place it in an existing container. Grid and carousel must be created via the container endpoint instead. Availability and limits depend on the connected account's Bitly plan.

Create a carousel or grid container for a set of content on a Bitly Site. Returns the created site block. Availability depends on the connected account's Bitly plan and site entitlements.

Attach a previously uploaded image to a Bitly Site and return its URL and GUID. This endpoint accepts image references, not base64 image data. Availability depends on the connected account's Bitly plan and site entitlements.

Generate a static QR image for raw content without creating or saving a Bitly QR resource. Returns base64 image bytes, not a hosted URL or data URI. Choose SVG or PNG and basic appearance options; gradients, frame, text, and logo are unsupported. Contact your Bitly Account Manager to enable this feature.

Create a Bitly webhook for an organization, optionally associated with a group. The destination URL may receive Bitly event data; configure only a trusted endpoint. Webhook availability depends on the connected account's plan; accounts without webhook entitlement must upgrade. Receiver OAuth client secrets cannot be set with this tool.

Permanently delete an eligible unedited hash Bitlink.

Permanently delete a QR code that has not been redirected and is not for a custom link. Also deletes the associated link, if applicable. Returns the deletion records reported by Bitly. Access depends on the connected account's permissions and plan entitlement.

Delete an existing Bitly Site by its GUID. Returns no content on success. Access depends on the connected account's permissions and Bitly plan entitlement.

Delete a block of any type from a Bitly Site, rather than deactivate it. Deleting a container block (grid or carousel) also deletes its contained blocks. Does not delete the link tied to the block. Returns no content on success. Access depends on the connected account's permissions and Bitly plan entitlement.

Delete a redirect for a Bitly Site by its site ID, custom domain, and keyword (back-half). Returns no content on success. Access depends on the connected account's permissions and Bitly plan entitlement.

Delete a Bitly webhook by GUID to stop its event deliveries. Returns no content on success. Requires access to the webhook and a Bitly plan supporting webhooks; upgrade your plan if Bitly returns 402.

Discard a Bitly Site's in-progress draft by its site GUID. Returns no content on success. Access depends on the connected account's permissions and Bitly plan entitlement.

Resolve a Bitlink to its current destination and destination history, when available.

Return the authenticated Bitly user together with accessible groups and organizations needed by other tools.

Retrieve aggregate analytics for Bitly Sites: overview, views over time or by city/country/device/referrer, button clicks over time or by city/country/device, top clicked buttons, or digital business card downloads over time. Choose one report per call. Availability depends on the report and plan; detailed traffic breakdowns require a paid analytics entitlement.

Retrieve full Bitlink metadata, including destination, title, tags, archive or deletion state, and associated QR code IDs.

Return paid-plan click or engagement analytics for a Bitlink as a timeline or summary. Requires Bitlink analytics entitlement.

Get Bitlink click analytics by AI agent, referrer name, or referrers grouped by domain. Choose exactly one metric per call. Requires access to the Bitlink and the selected analytics entitlement; some metrics require a paid plan.

Break down paid-plan Bitlink click analytics by country, city, device, referrer, or referring domain. Requires Bitlink analytics entitlement.

Retrieve a Bitly campaign by GUID to inspect its name, description, owning group, creator, timestamps, and resource references. The campaign must be accessible to the authenticated user. Requires a Bitly plan that supports campaigns; upgrade your plan if Bitly returns 402.

Retrieve a Bitly channel by GUID to inspect its name, owning group, creation and modification timestamps, and resource references. The channel must be accessible to the authenticated user. Requires a Bitly plan that supports channels; upgrade your plan if Bitly returns 402.

Retrieve a Custom Bitlink's details, current destination Bitlink, and redirect history. Supply the custom domain/back-half without a protocol. Requires access to the Custom Bitlink and a Bitly plan with the appropriate custom-link entitlement.

Retrieve time-bucketed clicks across a Custom Bitlink's entire history or click counts grouped by its historical destinations. Select clicks or clicks_by_destination and an analytics window. Requires access to the Custom Bitlink and a Bitly plan with the appropriate analytics entitlement.

Retrieve a Bitly custom domain's verification state, group assignments, redirects, deep-link applications, and SSL configuration. Requires membership in a group assigned to the domain or administrator access to its organization. Only organization administrators can read domains awaiting DNS verification. Account entitlements apply; upgrade your plan if Bitly returns 402.

Inspect a Bitly custom domain's current DNS records, detected DNS provider, required registrar records, and whether the records match a valid configuration. Use the required A records for a root domain or CNAME record for a subdomain to configure DNS at your registrar. Does not modify DNS. Requires access to the specified organization and domain; account entitlements apply. Upgrade your plan if Bitly returns 402.

Retrieve the registrar agreements a user must accept before Bitly registers a domain. Review their content and pass each accepted agreement_key to POST /domains when purchasing the domain. This read does not accept agreements or purchase a domain. Account entitlements apply; upgrade your plan if Bitly returns 402.

Retrieve a Bitly group by GUID, including its organization, your role, branded short domains, timestamps, and resource references. The group must be accessible to the authenticated user; account entitlements apply.

Retrieve one group analytics report: shorten counts, geography/devices/referrers, engagement rankings or timeline, link clicks, QR scans, historical usage, or agentic traffic rollup. Select metric and supply only that endpoint's parameters. Most metrics require unit and units. Analytics availability depends on Bitly plan entitlements; paid features return 402 without an upgrade. Returns provider fields without combining distinct rankings or response shapes.

Retrieve a Bitly group's preferences, including its preferred domain for shortened links. Requires access to the specified group; availability is subject to your Bitly account permissions and plan entitlements.

Retrieve tags currently used in a Bitly group for Bitlinks or QR codes. Returns at most 1000 tags; this endpoint has no documented pagination controls or continuation token. Requires access to the group and is subject to account entitlements; upgrade the connected plan if Bitly returns 402.

Retrieve a Bitly OAuth app by client ID to inspect its name, description, link, PKCE requirement, and first-party status. The authenticated account must have access to the app. Availability is subject to Bitly account permissions and entitlements; upgrade your plan if Bitly returns 402.

Retrieve a Bitly organization by GUID, including its subscription tier, your role, branded short domains, authentication requirements, timestamps, and resource references. The organization must be accessible to the authenticated user; account entitlements apply.

Read an organization's shorten counts over a specified time window, supplying unit and units. Set by_group=true to read counts by group for the current month instead, without time parameters. Returns the provider's metrics envelope. Availability depends on Bitly plan entitlements; a 402 requires a plan upgrade.

Retrieve a Bitly QR code by ID to inspect its destination, appearance, GS1 metadata, tags, expiration, and dynamic routing. Returns QR metadata, not an image. The connected account must have access to the QR code; feature availability depends on the Bitly plan.

Get a QR Code's scan timeline, total, or country, city, device OS or browser breakdown for a time window. Analytics availability depends on your Bitly plan; detailed reports may require an upgrade.

Retrieve an existing Bitly QR code's image as a base64 data URI in qr_code_image, suitable for an HTML image src. Choose SVG or PNG; SVG is the default. This does not create a QR code and does not return a hosted image URL. Access and image features depend on the connected account's Bitly plan and QR code permissions.

Retrieve a Bitly Site by its GUID, including content, appearance, and publication settings. Set include_blocks to retrieve its draft content blocks as well. Availability depends on the connected account's Bitly plan.

Retrieve one Bitly Site analytics report: country, city, device, or referrer views, link performance, a views timeline, or a views summary. Requires the connected account's site analytics entitlement; some reports require a paid plan. Link performance returns one page with provider pagination, not all pages.

Retrieve a group's top Bitlinks and decoupled QR codes ranked together by engagement count over a time window. Returns separate links and qr_codes lists plus sorted_engagements whose IDs preserve the unified ranking. Coupled QR codes are ranked by their Bitlink ID. Returns one bounded result set, not all history pages. Analytics access depends on Bitly plan entitlements.

Inspect monthly plan quotas, hourly endpoint budgets, and optional group feature usage before performing quota-consuming work.

Retrieve a Bitly webhook by GUID to inspect its delivery configuration, subscribed event, status, owning organization and group, and lifecycle timestamps. Requires access to the webhook and a Bitly plan supporting webhooks; upgrade your plan if Bitly returns 402.

List or search Bitlinks owned by a group, one cursor-controlled page at a time.

List verified custom domains the authenticated user can shorten links with, across all their organizations and groups. Any group member can call this endpoint; no organization-admin role is required. Returns domain names only, not setup or verification state; use List Custom Domains for those details. There are no pagination controls. Availability is subject to account entitlements; upgrade the connected plan if Bitly returns 402.

List campaigns for the authenticated Bitly user, optionally filtered by group GUID. This endpoint has no documented pagination controls. Requires a Bitly plan with campaign access; upgrade the connected account if Bitly returns 402.

List channels available to the authenticated Bitly user, optionally filtered by group GUID and campaign GUID. Use the returned channel GUIDs when working with campaigns. This endpoint has no documented pagination controls. Requires a Bitly plan with channel access; upgrade the connected account if Bitly returns 402.

List custom domains with verification states, group assignments, HTTPS settings, deep-link applications, and SSL certificate details. Optionally filter by organization GUID; otherwise returns domains for every organization where the authenticated caller is an admin. Organizations where the caller is not an admin are excluded. No pagination controls are documented. Account entitlements apply; upgrade the connected Bitly plan if Bitly returns 402.

List one page of QR codes in a Bitly group in reverse chronological order, optionally filtering by search text, destination, creation time, creator, tags, QR type, customization, GS1, archive, expiration, or dynamic routing status. Pass pagination.search_after back as search_after with the same filters to continue. Returns metadata, not images. The connected account must have access to the group; feature availability depends on the Bitly plan.

List available Bitly Site templates, optionally by onboarding category. Use a returned template_guid to apply a template to a site. Availability and use of paid templates depend on the connected account's Bitly plan.

List one page of active Bitly Sites owned by a group, optionally filtered by site URL. Pass pagination.search_after as search_after to request the next page. Availability depends on the connected account's Bitly plan.

Retrieve a group's Bitlinks ranked by clicks for a time window. Preserve the sorted_links order and join its IDs to links metadata by id, not array position. Returns one size-limited result with no documented continuation token. Requires access to the group and the appropriate Bitly analytics entitlement; upgrade the connected plan if Bitly returns 402.

List all webhooks available for a Bitly organization by organization GUID. This endpoint has no documented query filters or pagination controls. Requires a Bitly plan with webhook access; upgrade the connected account if Bitly returns 402.

Validate a YouTube video ID and construct the content needed for a Bitly Site YouTube video button without creating the button. Requires access to the site and the applicable Bitly Sites plan entitlement.

Publish a Bitly Site's draft, replacing the production site when changes have been made. Returns the site's publication and content settings. Availability depends on the connected account's Bitly plan.

Change the destination URL of a stand-alone Bitly QR code by QR code ID. QR codes already associated with a Bitlink must be updated via the Bitlinks API instead. Returns updated QR metadata, not an image. Redirecting a QR code may require a Bitly plan upgrade.

Register (purchase) a domain for a Bitly organization and configure its DNS. This creates a domain registration and consumes the organization's plan-included domain allowance; it is not a lookup or dry run. It is not a paid-domain checkout: Bitly rejects domains priced at or above the complimentary limit and requests after the included allowance is exhausted. Requires an organization admin and a plan with available included-domain entitlement. Obtain explicit user approval for registration and the agreements before calling. Select a domain from GET /domains and send agreement_keys from GET /domains/{domain}/agreements. DNS verification can take up to 48 hours; later read GET /custom_domains for validation_status.

Search domains Bitly can register for an organization. Returns available domain names and the status of the exact name searched for; this does not register or purchase a domain. Returns one set of up to 25 results with no documented pagination. Domain registration depends on organization plan entitlements; upgrade the connected Bitly plan if Bitly returns 402.

Create an ordinary Bitly short link for a long URL in a specific group.

Update safe metadata or archive state for a Bitlink; this tool does not redirect destinations or configure advanced routing.

Update a Bitly campaign's name, description, associated group, or channels. Supply campaign_guid and the fields to change; omitted fields are not sent. Returns the updated campaign details. Requires campaign access and a Bitly plan that includes campaigns; upgrade the plan if Bitly returns 402.

Update an existing Bitly channel by channel_guid, including its name, group, and Bitlink campaign associations. Supply only the fields to change; omitted fields are not sent. Returns updated channel details. Requires channel access and a Bitly plan supporting channels; upgrade if Bitly returns 402.

Move an existing custom keyword (back-half) to a different Bitlink. Supply custom_bitlink and the destination bitlink_id in domain/back-half form; their domains must match. Requires access to the Custom Domain and a Bitly plan with custom-link redirect entitlement. Returns the updated custom redirect, destination Bitlink, and redirect history.

Change a verified Bitly custom domain's redirects and HTTPS/HSTS settings. Supply custom_domain and only the settings to change; an empty root_redirect or wildcard_redirect clears that redirect. Domains awaiting DNS verification cannot be updated. Requires an organization administrator and a Bitly plan with the appropriate custom-domain entitlement. Returns the updated domain.

Update a Bitly group's name, associated organization, or branded short domains. Supply group_guid and the fields to change; omitted fields are not sent. Returns the updated group details. Requires permission to manage the group; availability depends on the connected account's Bitly plan.

Update a Bitly group's preferred short domain. Requires access to the group; branded domain availability depends on the account's plan and configured domains.

Update an existing Bitly QR code's title, appearance, archive status, expiration, tags, or dynamic routing rules by QR code ID. Returns QR metadata, not an image. Dynamic routing replaces all existing rules; an empty array clears them. Customizations and advanced features may require a Bitly plan upgrade.

Update a Bitly Site's URI, display name, description, or attached QR code. Changing the URI creates a redirect from the previous URI. A QR code can only be attached when the site does not already have one. Availability depends on the connected account's Bitly plan.

Update a Bitly Site's theme, layout, fonts, colors, images, header, buttons, and social icon appearance. Availability of appearance options depends on the connected account's Bitly plan. Bitly returns no site data on success.

Update an existing Bitly Site block's content, appearance, schedule, active or pinned state, or parent container. Send content fields appropriate to the stored block type; the type is derived from the existing block and cannot be changed. Availability depends on the connected account's Bitly plan.

Update the authenticated Bitly user's display name or default group. Supply the fields to change; omitted fields are not sent. Returns the updated user profile and email details. Availability depends on the connected account's permissions and Bitly plan.

Update an existing Bitly webhook's delivery destination, event, activity, organization, group, or OAuth settings. Supply webhook_guid for the path and guid for the required body identifier, plus the fields to change; omitted fields are not sent. Returns updated webhook details. Requires webhook access and a Bitly plan supporting webhooks; upgrade if Bitly returns 402. Receiver OAuth client secrets cannot be changed with this tool.

Upgrade a standalone (decoupled) QR code to a coupled QR code by associating it with its underlying Bitly short link. Returns Bitlink metadata, not a QR image. This consumes one encode from the organization's monthly Link limit; if the QR code is already coupled, no encode is consumed. Availability depends on your Bitly plan and remaining monthly Link quota.

Test an existing Bitly webhook's configuration by sending a ping event to its configured webhook URL. This sends an outbound request to the webhook receiver; it is not a read-only configuration check. Returns the webhook configuration and status. Requires access to the webhook and a Bitly plan supporting webhooks; upgrade your plan if Bitly returns 402.