> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tinyurl

> TinyURL shortens lengthy URLs, generating concise links for easier sharing and managing, often used in social media and marketing campaigns

![Tinyurl logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/tinyurl.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=58a25feabfa4f342ba5c9fcbbdc7611e)

* **Category:** url shortener
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 2
* **Triggers:** 0
* **Slug:** `TINYURL`
* **Version:** 20260615\_00

## Tools

> [accordion] Create short url
>
> **Slug:** `TINYURL_CREATE_SHORT_URL`
>
> Creates a shortened URL using TinyURL's API. This action takes a long URL and returns a shortened version, with optional parameters for customization like domain, alias, tags, and expiration date.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The long URL that needs to be shortened. Must be a valid URL starting with http\:// or https\://. Do NOT pass HTML content, placeholder strings like '\{url}', or any non-URL text. The value must be the actual URL to shorten.
>
> **tags** `array`
>
> Tags to associate with the URL (optional)
>
> **alias** `string`
>
> Custom alias for the shortened URL (optional) Must be unique per domain; if already taken, choose a different alias or change the `domain` parameter.
>
> **domain** `string`
>
> The domain to use for the shortened URL (optional)
>
> **expires\_at** `string`
>
> Expiration date for the URL in ISO 8601 format (optional)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List TinyURLs
>
> **Slug:** `TINYURL_LIST_URLS`
>
> Tool to retrieve a list of TinyURLs from your account. Use when you need to view available or archived shortened URLs. Supports pagination and filtering by URL type (available or archived).
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination. Must be greater than or equal to 1.
>
> **type** `string ("available" | "archived")` *required*
>
> The type of TinyURLs to retrieve. Use 'available' for active URLs or 'archived' for archived URLs.
>
> **limit** `integer`
>
> Number of results per page. Must be between 1 and 100.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
