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

# LinkTwin

> LinkTwin is a link management platform for creating shortened deep links, tracking analytics, and managing domains, pixels, QR codes, and collections.

![LinkTwin logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/link_twin.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=e8c43f97f1f0fadb2b05fece8aba3897)

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

## Tools

> [accordion] Create Link
>
> **Slug:** `LINK_TWIN_CREATE_LINK`
>
> Create a shortened deep link with optional access limits, targeting, query parameters, and pixel or collection assignments. Free accounts can shorten only LinkTwin-approved destination domains and apps; arbitrary destination websites require a paid plan.
>
> #### Input Parameters
>
> **note** `string`
>
> Private note used to identify or organize the link.
>
> **ab\_tests** `array`
>
> Alternative destinations and optional traffic percentages for A/B routing.
>
> **password** `string`
>
> Password visitors must enter before redirecting.
>
> **expires\_at** `string`
>
> Date and time after which the link expires.
>
> **click\_limit** `integer`
>
> Maximum successful redirects before the link expires.
>
> **geo\_targets** `array`
>
> Country-based redirect destinations; country must be a full, case-sensitive country name.
>
> **short\_domain** `string`
>
> Existing LinkTwin short domain returned by LINK\_TWIN\_LIST\_DOMAINS. Branded domains require a plan that enables them.
>
> **display\_title** `string`
>
> Custom display title for the link.
>
> **device\_targets** `array`
>
> Device-based redirect destinations.
>
> **destination\_url** `string` *required*
>
> Destination URL to shorten. On Free, it must belong to a LinkTwin-approved domain or app.
>
> **language\_targets** `array`
>
> Language-based redirect destinations.
>
> **query\_parameters** `array`
>
> Query parameters LinkTwin appends during redirect.
>
> **pixel\_ids\_or\_names** `string`
>
> Tracking pixels to assign. Use all numeric IDs or all names in one call; do not mix forms.
>
> **collection\_ids\_or\_names** `string`
>
> Collections to assign. Use all numeric IDs or all names in one call; do not mix forms.
>
> **expiration\_redirect\_url** `string`
>
> Fallback destination used after expiry or the click limit is reached.
>
> #### 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] Delete Link
>
> **Slug:** `LINK_TWIN_DELETE_LINK`
>
> Permanently delete one shortened link by numeric ID. This destructive action removes the link and its redirect and cannot be undone; use it only when the caller explicitly intends permanent deletion.
>
> #### Input Parameters
>
> **link\_id** `integer` *required*
>
> Numeric ID of the shortened link to permanently delete.
>
> #### 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] Get Account Info
>
> **Slug:** `LINK_TWIN_GET_ACCOUNT_INFO`
>
> Return the connected LinkTwin account's plan, usage, timezone, and feature limits. Use this before creating or updating links when plan availability is uncertain.
>
> #### 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] Get Link
>
> **Slug:** `LINK_TWIN_GET_LINK`
>
> Retrieve a LinkTwin shortened link by its numeric ID or full short URL. Returns its destination, targeting rules, collection and pixel assignments, access controls, and summary click analytics; an optional timezone controls returned dates.
>
> #### Input Parameters
>
> **timezone** `string`
>
> IANA timezone for returned analytics; defaults to the account timezone.
>
> **link\_id\_or\_short\_url** `string` *required*
>
> Numeric link ID or full LinkTwin short URL. Full URLs are safely encoded as one path segment.
>
> #### 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] Get Link Analytics
>
> **Slug:** `LINK_TWIN_GET_LINK_ANALYTICS`
>
> Return detailed clicks, unique clicks, time series, and geography, referrer, browser, device, language, and city breakdowns for one link. Free accounts retain only 14 days of analytics.
>
> #### Input Parameters
>
> **to\_date** `string`
>
> Inclusive end date as YYYY-MM-DD. Use only when from\_date is an explicit date; omit it for a preset window.
>
> **timezone** `string`
>
> IANA timezone for date boundaries and chart timestamps; defaults to the account timezone.
>
> **from\_date** `string` *required*
>
> Preset analytics window or explicit inclusive start date as YYYY-MM-DD. Results cannot exceed the account's retention period.
>
> **link\_id\_or\_short\_url** `string` *required*
>
> Numeric link ID or full LinkTwin short URL. Full URLs are safely encoded as one path segment.
>
> #### 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 Collections
>
> **Slug:** `LINK_TWIN_LIST_COLLECTIONS`
>
> Return one page of link collections available for organizing or assigning shortened links.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum collections to request in this page. LinkTwin does not publish a maximum.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a previous call. Omit for the first page.
>
> #### 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 Domains
>
> **Slug:** `LINK_TWIN_LIST_DOMAINS`
>
> Return standard LinkTwin short domains and branded domains available to the connected account. Branded domains are disabled on Free accounts.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum branded domains to request in this page. Standard LinkTwin domains may be returned in addition to this limit.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a previous call. Omit for the first page.
>
> #### 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 Links
>
> **Slug:** `LINK_TWIN_LIST_LINKS`
>
> Return one filtered page of shortened links owned by the connected account, including destination URLs, click totals, and assignments.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum links to request in this page. LinkTwin does not publish a maximum.
>
> **order** `string ("date" | "date_desc" | "date_asc" | "clicks_desc" | "clicks_asc" | "name_asc" | "name_desc")`
>
> Sort order for the returned links.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a previous call. Omit for the first page.
>
> **search** `string`
>
> Search text used to filter links.
>
> **date\_to** `string`
>
> Inclusive creation-date upper bound as YYYY-MM-DD or an ISO 8601 datetime.
>
> **timezone** `string`
>
> IANA timezone used to interpret date filters; defaults to the account timezone.
>
> **date\_from** `string`
>
> Inclusive creation-date lower bound as YYYY-MM-DD or an ISO 8601 datetime.
>
> **collection\_ids** `array`
>
> Collection IDs to filter by. They are serialized as the JSON-encoded collections query value LinkTwin expects.
>
> #### 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 Pixels
>
> **Slug:** `LINK_TWIN_LIST_PIXELS`
>
> Return one page of tracking pixels available for assignment to shortened links.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum tracking pixels to request in this page. LinkTwin does not publish a maximum.
>
> **cursor** `string`
>
> Opaque continuation cursor returned by a previous call. Omit for the first page.
>
> #### 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] Update Link
>
> **Slug:** `LINK_TWIN_UPDATE_LINK`
>
> Partially update a shortened link's destination, access limits, targeting, query parameters, or assignments. Only explicitly supplied fields are changed; replacement arrays overwrite the complete existing value. Changing the destination URL requires a paid LinkTwin plan.
>
> #### Input Parameters
>
> **note** `string`
>
> Replacement private note. Pass null to clear it; omit to leave unchanged.
>
> **link\_id** `integer` *required*
>
> Numeric ID of the shortened link to update.
>
> **ab\_tests** `array`
>
> Complete replacement A/B destination list. Pass \[] to clear A/B routing.
>
> **password** `string`
>
> Replacement visitor password. Pass null to clear it; omit to leave unchanged.
>
> **expires\_at** `string`
>
> Replacement expiry datetime. Pass null to clear it; omit to leave unchanged.
>
> **click\_limit** `integer`
>
> Replacement successful-redirect limit. Pass null to clear it; omit to leave unchanged.
>
> **geo\_targets** `array`
>
> Complete replacement country-target list. Pass \[] to clear all country targets.
>
> **short\_domain** `string`
>
> Existing LinkTwin short domain returned by LINK\_TWIN\_LIST\_DOMAINS. Omit to leave unchanged; null is not accepted.
>
> **display\_title** `string`
>
> Replacement display title. Pass null to clear it; omit to leave unchanged.
>
> **device\_targets** `array`
>
> Complete replacement device-target list. Pass \[] to clear all device targets.
>
> **destination\_url** `string`
>
> New destination URL. Changing a link's destination requires a paid LinkTwin plan, even when the new URL uses an approved domain. Omit to leave unchanged; null is not accepted.
>
> **language\_targets** `array`
>
> Complete replacement language-target list. Pass \[] to clear all language targets.
>
> **query\_parameters** `array`
>
> Complete replacement redirect-query list. Pass \[] to clear all query parameters.
>
> **pixel\_ids\_or\_names** `array`
>
> Complete replacement pixel assignment list. Use either all numeric IDs or all names in one call; pass \[] to clear all assignments.
>
> **collection\_ids\_or\_names** `array`
>
> Complete replacement collection assignment list. Use either all numeric IDs or all names in one call; pass \[] to clear all assignments.
>
> **expiration\_redirect\_url** `string`
>
> Replacement destination used after expiry or the click limit. Pass null to clear it; omit to leave unchanged.
>
> #### 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
