# Tinyurl

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

- **Category:** url shortener
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 2
- **Triggers:** 0
- **Slug:** `TINYURL`
- **Version:** 20260223_00

## Tools

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | 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 | No | Tags to associate with the URL (optional) |
| `alias` | string | No | 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 | No | The domain to use for the shortened URL (optional) |
| `expires_at` | string | No | Expiration date for the URL in ISO 8601 format (optional) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Must be greater than or equal to 1. |
| `type` | string ("available" | "archived") | Yes | The type of TinyURLs to retrieve. Use 'available' for active URLs or 'archived' for archived URLs. |
| `limit` | integer | No | Number of results per page. Must be between 1 and 100. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
