Short.io is a URL shortening service that allows users to create branded short links, manage them, and track their performance.
Short.io is a URL shortening service that allows users to create branded short links, manage them, and track their performance. On Nagent, Short Io is exposed as a fully-configurable url shortener integration that any agent can call — 41 actions, and API key authentication. No code is required to wire Short Io into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Short Io to automate the kinds of tasks url shortener teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Short Io into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Short Io, with input parameters and output schema. Drop these into any step of an agent built in Helix.
SHORT_IO_ADD_TAG_TO_LINKS_BULKTool to append a single tag to multiple short links in one call. Use when you need to add the same tag to multiple links efficiently.
Input parameters
The tag name to append to all specified links. This tag will be added to the existing tags on each link.
List of link IDs to which the tag will be appended. Link IDs follow the format lnk_\[0-9a-zA-Z\]+_\[0-9a-zA-Z\]+.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_ARCHIVE_LINKArchive a short link, hiding it from the dashboard while keeping it accessible. Archived links remain functional but are hidden from the dashboard view. Use this to organize or hide links without deleting them.
Input parameters
The unique identifier of the short link to archive (format: lnk_XXXXX_YYYYYYYYYYYYYYYYYYYY).
Optional domain ID to scope the archive operation to a specific domain.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_CREATE_FOLDERTool to create a new folder for organizing links within a domain. Use when you need to organize links into categories or groups.
Input parameters
The name of the folder to create.
The domain ID to create the folder under. Obtain from Domain Settings in Short.io Dashboard.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_CREATE_LINKTool to create a new short link from a long URL on your branded domain. Use when you need to shorten a single URL.
Input parameters
Custom path/slug for the short link. If not provided, a random path will be generated.
Title for the link for organizational purposes.
Domain name for the short link (must be a domain from your Short.io account).
The original long URL to be shortened.
Whether to allow creating duplicate links for the same originalURL. Defaults to false.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_DELETE_LINKTool to permanently delete a short link by its unique ID. Use when you need to remove a short link from the system. The deletion is immediate and irreversible.
Input parameters
The unique identifier of the short link to delete (format: lnk_XXXXX_YYYYYYYYYYYYYYYYYYYY).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_DELETE_LINK_PERMISSIONRevokes a specific user's access permission for a short link. Use this to remove a user's ability to view or manage a particular link within a domain. Requires Team plan.
Input parameters
Unique identifier of the short link (starts with 'lnk_', obtained from link creation responses)
Numeric ID of the user whose permission will be revoked
Numeric ID of the domain containing the link (e.g., obtained from link creation responses)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_DELETE_LINKS_BULKDelete multiple short links in a single API call (up to 150 links). Rate limit: 1 request per second. Use this to permanently remove links - deleted links cannot be recovered.
Input parameters
Array of link identifiers to delete in bulk. Maximum 150 items. Each ID must match pattern ^lnk_(.*)(.*).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_DUPLICATE_LINKTool to duplicate an existing short link by its ID. Creates a new link with the same properties as the original. Use when you need to clone a link configuration.
Input parameters
The unique identifier of the link to duplicate (format: lnk_XXXXX_YYYYYYYYYYYYYYYYYYYY).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GENERATE_QR_CODETool to generate a QR code for a short link. Use when you need to create a QR code image for a specific short link by its ID.
Input parameters
QR code format type. Defaults to 'png'.
The unique identifier of the short link (format: lnk_XXXXX_YYYYYYYYYYYYYYYYYYYY).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_BUNDLE_TEMPLATESTool to retrieve all available bundle templates. Use when you need to list or select from predefined bundle templates for creating link bundles.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_DOMAIN_BY_IDTool to retrieve detailed information for a specific domain by its ID. Use when you need to fetch configuration details, settings, or metadata for a domain.
Input parameters
Unique identifier of the domain to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_DOMAINS_LINK_CLICKSTool to get click statistics for specific links in a domain. Use when you need click counts for particular link IDs within a domain. Retrieves the number of clicks each specified link has received. Example: "Get click counts for links with IDs \['lnk_5YOn_turb6oFhe1NAosVTgOpq6', 'lnk_5YOn_WziFZJY3qcd1YDqVdRWg9'\] in domain 1425403".
Input parameters
List of link IDs to get click counts for. Link IDs typically start with 'lnk_' prefix.
Numeric identifier of the domain to retrieve link click statistics for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_DOMAINS_PATHSTool to list the most popular paths in a domain over time. Use after confirming a valid domain ID to analyze which short URL paths under that domain have received the most clicks in the given interval.
Input parameters
Timezone name for date boundaries (e.g., 'UTC', 'America/New_York').
Time interval for which to retrieve the most popular paths. Use 'custom' to supply startDate and endDate.
End date (YYYY-MM-DD) for custom period; required when period='custom'. Automatically converted to milliseconds from epoch.
Identifier of the domain whose path statistics will be retrieved.
Start date (YYYY-MM-DD) for custom period; required when period='custom'. Automatically converted to milliseconds from epoch.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_DOMAIN_STATISTICSTool to get comprehensive statistics for a domain over a specified period. Returns click metrics, link counts, and analytics breakdowns by referrer, social media, browser, country, city, and OS. Use when you need domain-level analytics.
Input parameters
Statistics period. Use 'custom' for custom date range with startDate and endDate.
End date timestamp in milliseconds (required when period is 'custom').
The domain ID to get statistics for.
Timezone offset for statistics calculation (e.g., '0' for UTC).
Start date timestamp in milliseconds (required when period is 'custom').
Granularity for click statistics chart; one of hour, day, week, month.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_FOLDERTool to retrieve folder details by ID. Use when you need to get information about a specific folder within a domain.
Input parameters
The domain ID that the folder belongs to.
The unique folder ID to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_LINK_BY_ORIGINAL_URLTool to get link info by original URL. Use when you need to find all short links created from a specific original URL within a domain.
Input parameters
The domain name to search within (e.g., example.short.gy)
The original long URL to search for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_LINK_COUNTRIESTool to get country targeting rules for a short link. Use when you need to retrieve all country-based redirect configurations for a specific link.
Input parameters
Unique identifier of the link to fetch country-targeting rules for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_LINK_INFO_BY_LINK_IDRetrieves comprehensive metadata for a short link using its unique ID. Returns original URL, short URL, domain, tags, click count, UTM parameters, timestamps, and more. Use this when you have a link ID and need its full details.
Input parameters
The unique identifier of the short link (format: lnk_XXXXX_YYYYYYYYYYYYYYYYYYYY).
Optional domain ID to filter results when the link ID might exist across multiple domains. Usually not needed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_LINK_INFO_BY_PATHTool to get link info by its path and domain. Use when you need to look up a branded short link by its path within a specific domain.
Input parameters
Short link path segment (the part after the domain) to look up.
Identifier of the domain under which the short link resides.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_LINK_OPEN_GRAPH_PROPERTIESTool to retrieve OpenGraph settings for a link. Use after creating or updating a link to verify its social metadata.
Input parameters
The unique identifier of the short link to retrieve OpenGraph properties for.
Identifier of the branded domain where the link is hosted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_LINK_PERMISSIONSRetrieves all user access permissions for a specific short link within a domain. Use this to check which users have been granted access to view or manage a particular link. Returns an empty list if no special permissions have been configured. Example: "Show me who has access to link 'lnk_5YOn_lR5wxdiv88Qo9ZRF6akPi' in domain '1425403'".
Input parameters
Unique identifier of the short link (starts with 'lnk_', obtained from link creation responses)
Numeric ID of the domain containing the link (e.g., obtained from link creation responses)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_LINK_REGION_LIST_COUNTRYTool to list all regions available for a country. Use when targeting links by region within a specific country.
Input parameters
Country code in ISO 3166-1 alpha-2 format
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_LINK_REGIONSRetrieves all region-based targeting rules configured for a specific short link. Region targeting allows you to redirect users to different URLs based on their geographic region (e.g., California, Texas) within a country. This provides more granular control than country-level targeting. Returns an empty list if no region targeting rules are configured for the link.
Input parameters
Unique identifier of the link to fetch region-targeting rules for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_LINKS_BY_ORIGINAL_URLTool to get multiple links info by original URL. Use when you need to find all short links created from the same original URL within a domain, such as comparing campaign performance across different platforms.
Input parameters
The domain name to search within (e.g., example.short.gy)
The original long URL to find short links for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_LINKS_LISTTool to list short links on a domain with optional filters. Use after confirming the domain to retrieve or search links by criteria.
Input parameters
Maximum number of links to return per request
Filter links belonging to a specific folder
Filter by specific link identifier
ISO 8601 formatted date-time to retrieve links created after this timestamp
Filter by creation date
REQUIRED. ID of the domain to list links from. Obtain via SHORT_IO_POST_LINKS_BULK or from Domain Settings in Short.io Dashboard.
Token for pagination through result sets
ISO 8601 formatted date-time to retrieve links created before this timestamp
Date sort order
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_LINK_STATISTICSTool to get click statistics for a specific link. Use when you need detailed click metrics over a specified interval.
Input parameters
IANA timezone for grouping; defaults to UTC.
Unique identifier of the short link.
Time interval for statistics; defaults to last30. Use 'custom' for custom dates.
End date for custom interval (YYYY-MM-DD); required if period is 'custom'.
Whether to skip top referrer records; defaults to false.
Start date for custom interval (YYYY-MM-DD); required if period is 'custom'.
Granularity for click statistics chart; one of hour, day, week, month.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_GET_LINK_TWEETBOTCreate a short link using the simplified Tweetbot GET endpoint. This is a lightweight alternative to the standard POST link creation endpoint, designed for scenarios where GET requests are preferred (e.g., browser-based integrations, simple HTTP clients). Returns the shortened URL immediately upon success.
Input parameters
Custom path/slug for the short link. If not provided, a random path will be generated. Must be unique within the domain.
Optional title/description for the link. This metadata helps identify the link's purpose.
Domain hostname to create the short link on. Must be a domain you have access to in your Short.io account (e.g., 'yourdomain.short.gy' or a custom domain).
Note: This parameter may not be supported by the API. Leave unset for normal operation.
The full URL to shorten. Must include the protocol (http:// or https://).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_LIST_DOMAINSTool to retrieve all domains associated with the Short.io account. Use when you need to list available domains for creating short links or managing domain settings.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_LIST_FOLDERSTool to list all folders for a specific domain. Use when you need to view all folder names and IDs to organize or filter links by folder.
Input parameters
REQUIRED. Domain ID to list folders from. Obtain from Domain Settings in Short.io Dashboard.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_POST_DOMAIN_LINK_CLICKSTool to get click statistics for specific links in a domain using POST method. Use when you need click counts for multiple link paths with their creation dates. This POST version allows batch retrieval of link click statistics by providing an array of paths and their creation timestamps.
Input parameters
Returns statistics for clicks before given date (format: YYYY-MM-DD).
Numeric identifier of the domain to retrieve link click statistics for.
Returns statistics for clicks after given date (format: YYYY-MM-DD).
List of link paths with their creation dates to get click counts for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_POST_DOMAINS_BY_INTERVALTool to retrieve domain statistics over a custom interval. Use when you need time-series click data for a specific domain over a defined time window.
Input parameters
IANA timezone name for interval boundaries; defaults to 'UTC'.
Time interval for statistics. Defaults to 'last30'. Use 'custom' to specify a start and end date.
End date (YYYY-MM-DD) for custom interval; required if period is 'custom'.
Identifier of the domain to fetch statistics for.
Start date (YYYY-MM-DD) for custom interval; required if period is 'custom'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_POST_DOMAINS_LAST_CLICKSTool to retrieve the latest raw click events for a domain. Use when detailed clickstream data is needed.
Input parameters
IANA timezone for grouping; defaults to UTC.
Maximum number of click events to retrieve; defaults to 30.
Preset time interval; use 'custom' with startDate and endDate.
End date for 'custom' period (YYYY-MM-DD).
Filters to exclude specific click events.
Filters to include specific click events.
Identifier of the domain to fetch click events for.
Pagination: return events after this date.
Start date for 'custom' period (YYYY-MM-DD).
Pagination: return events before this date.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_POST_DOMAIN_STATSTool to get detailed statistics for a domain over a specified period. Use when you need comprehensive domain metrics including clicks, links, referrers, geographic data, and browser/OS breakdowns.
Input parameters
IANA timezone name for interval boundaries; defaults to UTC.
Time interval for statistics. Use 'custom' to specify custom dates.
End date (YYYY-MM-DD) for custom interval; required if period is 'custom'.
Filter structure for including or excluding specific click records.
Filter structure for including or excluding specific click records.
Identifier of the domain to fetch statistics for.
Whether to skip top referrer/browser/country records.
Start date (YYYY-MM-DD) for custom interval; required if period is 'custom'.
Granularity for click statistics chart.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_POST_DOMAINS_TOPRetrieves top values for a specified analytics column ranked by click count for a domain. Use to analyze which paths, countries, or other dimensions have the most traffic. Returns an ordered list of values with their click counts.
Input parameters
Maximum number of top values to return; must be at least 1.
Column to rank by click count. Common values: 'path' (link paths), 'country' (visitor countries). Note: Not all column names may be supported by the API.
Identifier of the domain for which to retrieve top column values.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_POST_LINKS_ARCHIVE_BULKArchive multiple short links in a single API call (up to 150 links). Archived links are hidden from the dashboard but remain functional and accessible. Use this to organize or hide links without deleting them. Requires link IDs from previously created links.
Input parameters
List of short link IDs to archive in bulk (maximum 150 items per request). Use link IDs from created links.
Optional domain ID to scope the archive operation to a specific domain.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_POST_LINKS_BULKTool to create up to 1000 short links in one call. Use when bulk shortening multiple URLs.
Input parameters
List of link objects to be shortened (up to 1000 items). Each object must include `originalURL` as a fully-formed HTTPS URL. Custom `path` values must be unique across existing short links to avoid collisions.
Domain under which the short links will be created. Must exactly match a domain already owned and configured in your Short.io account; arbitrary or unregistered domains will fail.
Whether duplicate links are allowed (defaults to false).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_POST_LINKS_QR_BULKTool to generate QR codes for multiple links in bulk. Use when you need to retrieve QR codes for several short links at once.
Input parameters
Size of the QR code (1-99).
Image format for QR codes. Defaults to 'png'.
Foreground color for QR code (hex code without # prefix, e.g., '000000' or 'FF0000').
List of up to 150 link IDs to generate QR codes for.
Optional domain ID to override default domain settings.
If true, disables the 'eye' excavation in the QR code.
Background color for QR code (hex code without # prefix, e.g., 'FFFFFF' or 'F0F0F0').
Whether to apply domain-level QR settings. Defaults to true.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_POST_LINKS_UNARCHIVE_BULKUnarchive multiple short links in bulk (up to 150 links per request). This operation restores previously archived links to active status, making them functional and visible again. Use this when you need to restore visibility of a set of archived short links at once. The operation is idempotent - unarchiving already unarchived links succeeds without error.
Input parameters
List of short link IDs to unarchive. Each ID should be in the format 'lnk_...' (maximum 150 links per request).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_UNARCHIVE_LINKUnarchive a previously archived short link to restore it to active status. Use this when you need to make an archived link visible and functional again. The operation is idempotent - unarchiving an already active link succeeds without error.
Input parameters
The unique identifier of the link to unarchive (format: lnk_XXXXX_YYYYYYYYYYYYYYYYYYYY).
Optional domain identifier to scope the operation to a specific domain.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_UPDATE_DOMAIN_SETTINGSTool to update domain settings for a Short.io domain. Use when you need to modify domain configuration such as the root redirect URL.
Input parameters
The unique identifier of the domain to update.
URL to redirect customers when visiting your short domain root. If not provided, the existing redirect URL remains unchanged.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SHORT_IO_UPDATE_LINKTool to update an existing short link by its ID. Allows modifying destination URL, title, UTM parameters, password protection, expiration, tags, and various other link settings. Only specified fields are updated; omitted fields remain unchanged. Use when you need to edit any aspect of a previously created short link.
Input parameters
Time-to-live: auto-delete the link after this duration. Accepts milliseconds or ISO 8601 duration string.
Custom path/slug for the short link (must be unique within the domain).
Array of tags to categorize the link.
Title or name for the link for organizational purposes.
The unique identifier of the link to update (format: lnk_XXXXX_YYYYYYYYYYYYYYYYYYYY).
If true, prevents merging query string parameters from the short URL to the destination URL.
UTM term parameter automatically appended to destination URL for analytics tracking.
Archive or unarchive the link. Archived links remain accessible but are hidden from main lists.
Enable cloaking to hide the destination URL from visitors (they see the short URL in the browser).
Set a password to restrict access to the link. Visitors must enter this password before being redirected.
Alternate destination URL for A/B testing. Traffic is split based on splitPercent.
Override link creation date in milliseconds timestamp.
Link expiration date/time. Accepts milliseconds timestamp (e.g., '1704067200000') or ISO 8601 string (e.g., '2024-01-01T00:00:00.000Z').
Destination URL specifically for iPhone/iOS devices (deep linking).
UTM medium parameter automatically appended to destination URL for analytics tracking.
UTM source parameter automatically appended to destination URL for analytics tracking.
Destination URL specifically for Android devices (deep linking).
URL to redirect visitors to after the link expires.
UTM content parameter automatically appended to destination URL for analytics tracking.
Maximum number of clicks allowed. Link will be disabled after reaching this limit.
New destination URL to update.
UTM campaign parameter automatically appended to destination URL for analytics tracking.
HTTP redirect status code: 301 (permanent), 302 (temporary), 307 (temporary preserving method), or 308 (permanent preserving method).
Percentage of traffic (1-100) to send to splitURL for A/B testing.
Facebook pixel/integration parameter for conversion tracking.
Google Analytics integration parameter.
Google Tag Manager integration parameter.
If true, provides your email to users so they can request the password.
Adroll pixel/integration parameter for ad retargeting.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 93 agents privately built on Nagent that already use Short Io.
Build on Nagent
Connect Short Io to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Short Io, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Short Io is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Short Io is connected, you configure its 41 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Short Io steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Short Io event fires, the agent kicks off automatically.
Every Short Io action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Short Io ships with 41 pre-built url shortener actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Short Io together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Short Io-based workflows tailored to your business.