Short link management platform with analytics and API for creating, managing, and tracking branded short links
Short link management platform with analytics and API for creating, managing, and tracking branded short links On Nagent, Dub is exposed as a fully-configurable url shortener integration that any agent can call — 17 actions, and API_KEY, OAUTH2 authentication. No code is required to wire Dub into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Dub 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 Dub 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 Dub, with input parameters and output schema. Drop these into any step of an agent built in Helix.
DUB_BULK_DELETE_LINKSTool to delete multiple short links in bulk from Dub. Use when you need to remove multiple links at once. Maximum of 100 link IDs per request. Non-existing IDs are silently ignored.
Input parameters
List of link IDs to delete. Maximum of 100 IDs. Non-existing IDs will be ignored. Each ID should be in the format 'link_XXXXX' or similar.
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
DUB_BULK_UPDATE_LINKSTool to update multiple short links in bulk. Use when you need to apply the same updates to multiple links at once by specifying link IDs or external IDs.
Input parameters
The fields to update for all specified links.
The IDs of the links to update. Takes precedence over `externalIds`. Maximum 100 items.
The external IDs of the links to update as stored in your database. Maximum 100 items.
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
DUB_CREATE_DOMAINTool to add a domain to a Dub workspace. Use when you need to create a new domain for shortening links. The domain must be verified before it can be used for link shortening.
Input parameters
The logo of the domain
Name of the domain (e.g., yourbrand.com)
Whether to archive this domain. False will unarchive a previously archived domain
assetLinks.json configuration file (for deep link support on Android)
Redirect users to a specific URL when any link under this domain has expired
Redirect users to a specific URL when a link under this domain doesn't exist
Provide context to your teammates in the link creation modal by showing them an example of a link to be shortened
apple-app-site-association configuration file (for deep link support on iOS)
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
DUB_CREATE_TAGTool to create a new tag in Dub. Use when you need to organize links by creating custom tags. Tags help categorize and filter links for better organization.
Input parameters
The name of the tag to create. Must be between 1 and 50 characters.
The color of the tag. If not provided, a random color will be assigned from the available options: red, yellow, green, blue, purple, brown, pink.
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
DUB_DELETE_DOMAINTool to delete a domain from your Dub workspace. Use when you need to permanently remove a domain. The domain must exist and be owned by your workspace.
Input parameters
The domain name to delete.
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
DUB_DELETE_TAGTool to delete a tag from Dub. Use when you need to remove a tag that is no longer needed.
Input parameters
The ID of the tag to delete.
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
DUB_GET_LINK_INFOTool to retrieve details of a specific short link from Dub. Use when you need to get comprehensive information about a link including its configuration, targeting settings, and performance metrics.
Input parameters
The key of the link to retrieve. E.g. for `d.to/github`, the key is `github`. Must be used together with domain parameter.
The domain of the link to retrieve. E.g. for `d.to/github`, the domain is `d.to`. Must be used together with key parameter.
The unique ID of the short link.
This is the ID of the link in your database. Must be prefixed with 'ext_' when querying.
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
DUB_GET_LINKSTool to retrieve a paginated list of links for the authenticated workspace. Use when you need to list links with optional filtering by domain, tags, folder, search terms, or user. Supports pagination and sorting for efficient retrieval of large link collections.
Input parameters
The page number for pagination.
DEPRECATED. Use `sort_by` instead.
Deprecated: Use `tag_ids` instead. The tag ID to filter the links by.
The domain to filter the links by. E.g. `ac.me`. If not provided, all links for the workspace will be returned.
The search term to filter the links by. The search term will be matched against the short link slug and the destination url.
The field to sort the links by. The default is `createdAt`.
The tag IDs to filter the links by.
The user ID to filter the links by.
The folder ID to filter the links by.
The number of items per page.
The unique name of the tags assigned to the short link (case insensitive).
The ID of the tenant that created the link inside your system. If set, will only return links for the specified tenant.
DEPRECATED. Filter for links that have at least one tag assigned to them.
The sort order. The default is `desc`.
Whether to include archived links in the response. Defaults to `false` if not provided.
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
DUB_GET_LINKS_COUNTTool to retrieve the count of links in workspace with optional filters. Use when you need to get the total number of links matching specific criteria such as domain, tags, folder, or search terms.
Input parameters
Deprecated: Use `tag_ids` instead. The tag ID to filter the links by.
The domain to filter the links by. E.g. `ac.me`. If not provided, all links for the workspace will be returned.
The search term to filter the links by. The search term will be matched against the short link slug and the destination url.
The tag IDs to filter the links by.
The user ID to filter the links by.
The field to group the links by.
The folder ID to filter the links by.
The unique name of the tags assigned to the short link (case insensitive).
The ID of the tenant that created the link inside your system. If set, will only return links for the specified tenant.
DEPRECATED. Filter for links that have at least one tag assigned to them.
Whether to include archived links in the response. Defaults to `false` if not provided.
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
DUB_GET_TAGSTool to retrieve a list of tags from Dub. Use when you need to fetch all tags or search for specific tags by name or IDs. Supports pagination and sorting by name or creation date.
Input parameters
IDs of tags to filter by.
The page number for pagination.
The search term to filter the tags by.
The field to sort the tags by.
The number of items per page.
The order to sort the tags by.
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
DUB_GET_WORKSPACETool to retrieve detailed information for a specific workspace. Use when you need to get workspace details including plan, usage limits, domains, users, and configuration settings.
Input parameters
The ID or slug of the workspace.
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
DUB_LIST_DOMAINSTool to retrieve a list of domains for the authenticated workspace. Use when you need to view all domains, search for specific domains, or filter domains by archived status. Supports pagination for large result sets.
Input parameters
The page number for pagination.
The search term to filter the domains by.
Whether to include archived domains in the response. Defaults to false if not provided.
The number of items per page.
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
DUB_TRACK_OPENTool to track a deep link open event in Dub. Use when you need to record when a user opens your app via a deep link. Supports both direct tracking via deepLink parameter or probabilistic tracking via dubDomain parameter.
Input parameters
The deep link that brought the user to the app. If left blank, Dub will fallback to probabilistic tracking by using the dubDomain parameter to check if there is an associated click event for the user's IP address. Learn more: https://d.to/ddl
Your deep link custom domain on Dub (e.g. 'acme.link'). This is used in probabilistic tracking to check if there is an associated click event for the user's IP address. Learn more: https://d.to/ddl
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
DUB_UPDATE_DOMAINTool to update a domain configuration in Dub. Use when you need to modify domain settings like redirect URLs, placeholder text, archive status, or deep linking configurations.
Input parameters
The logo of the domain (URL or data URI)
The domain name to update (e.g., 'acme.com'). This is the identifier of the domain you want to modify.
Whether to archive this domain. Set to false to unarchive a previously archived domain
New name of the domain if you want to rename it
assetLinks.json configuration file (for deep link support on Android)
Redirect users to a specific URL when any link under this domain has expired
Provide context to your teammates in the link creation modal by showing them an example of a link to be shortened
Redirect users to a specific URL when a link under this domain doesn't exist
apple-app-site-association configuration file (for deep link support on iOS)
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
DUB_UPDATE_TAGTool to update an existing tag by ID. Use when you need to change the name or color of a tag.
Input parameters
The ID of the tag to update.
The name of the tag to update.
The color of the tag. Must be one of: red, yellow, green, blue, purple, brown, pink.
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
DUB_UPDATE_WORKSPACETool to update workspace settings in Dub. Use when you need to modify workspace name, slug, logo, or conversion tracking settings.
Input parameters
URL of the workspace logo image.
The name of the workspace. Must be between 1 and 32 characters.
The slug of the workspace. Must be between 3 and 48 characters.
The ID or slug of the workspace to update.
Whether the workspace has conversion tracking enabled automatically for new links (d.to/conversions).
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
DUB_UPSERT_LINKTool to create or update a short link in Dub. Use when you need to create a new short link or update an existing one. If the link already exists (matching domain and key), it will be updated; otherwise, a new link will be created.
Input parameters
Geo targeting information for the short link in JSON format `{\[COUNTRY\]: https://example.com }`. See https://d.to/geo for more information
The iOS destination URL for the short link for iOS device targeting
The short link slug. If not provided, a random 7-character slug will be generated
The referral tag of the short link. If set, this will populate or override the `ref` query parameter in the destination URL
The destination URL of the short link
The custom link preview image (og:image). Will be used for Custom Link Previews if `proxy` is true. Learn more: https://d.to/og
Whether the short link uses Custom Link Previews feature. Defaults to `false` if not provided
Deprecated: Use `tagIds` instead. The unique ID of the tag assigned to the short link
The custom link preview title (og:title). Will be used for Custom Link Previews if `proxy` is true. Learn more: https://d.to/og
The custom link preview video (og:video). Will be used for Custom Link Previews if `proxy` is true. Learn more: https://d.to/og
The domain of the short link (without protocol). If not provided, the primary domain for the workspace will be used (or `dub.sh` if the workspace has no domains)
The prefix of the short link slug for randomly-generated keys (e.g. if prefix is `/c/`, generated keys will be in the `/c/:key` format). Will be ignored if `key` is provided
The unique IDs of the tags assigned to the short link. Can be a single tag ID string or an array of tag IDs
The Android destination URL for the short link for Android device targeting
Allow search engines to index your short link. Defaults to `false` if not provided. Learn more: https://d.to/noindex
Whether the short link uses link cloaking. Defaults to `false` if not provided
Whether the short link is archived. Defaults to `false` if not provided
The comments for the short link
The unique ID existing folder to assign the short link to
The password required to access the destination URL of the short link
The unique name of the tags assigned to the short link (case insensitive). Can be a single tag name string or an array of tag names
The ID of the tenant that created the link inside your system. If set, it can be used to fetch all links for a tenant
The UTM term of the short link. If set, this will populate or override the UTM term in the destination URL
The date and time when the short link will expire at in ISO-8601 format
The length of the short link slug. Defaults to 7 if not provided. When used with `prefix`, the total length of the key will be `prefix.length + keyLength`
The ID of the partner the short link is associated with
The ID of the program the short link is associated with
The URL to redirect to when the short link has expired
The ID of the link in your database. If set, it can be used to identify the link in future API requests (must be prefixed with 'ext_' when passed as a query parameter). This key is unique across your workspace
The UTM medium of the short link. If set, this will populate or override the UTM medium in the destination URL
The UTM source of the short link. If set, this will populate or override the UTM source in the destination URL
An array of webhook IDs to trigger when the link is clicked. These webhooks will receive click event data
The custom link preview description (og:description). Will be used for Custom Link Previews if `proxy` is true. Learn more: https://d.to/og
Deprecated: Use `dashboard` instead. Whether the short link's stats are publicly accessible. Defaults to `false` if not provided
The UTM content of the short link. If set, this will populate or override the UTM content in the destination URL
An array of A/B test URLs and the percentage of traffic to send to each URL. Must have 2-4 variants
The UTM campaign of the short link. If set, this will populate or override the UTM campaign in the destination URL
The date and time when the tests started in ISO-8601 format
The date and time when the tests were or will be completed in ISO-8601 format
Whether to track conversions for the short link. Defaults to `false` if not provided
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 35 agents privately built on Nagent that already use Dub.
Build on Nagent
Connect Dub 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 Dub, and click "Connect Now." You'll authenticate with API_KEY, OAUTH2 — Nagent handles credential storage and refresh automatically. Once connected, Dub is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Dub is connected, you configure its 17 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Dub 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 Dub event fires, the agent kicks off automatically.
Every Dub 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 Dub ships with 17 pre-built url shortener actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Dub together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Dub-based workflows tailored to your business.