Dub
dubShort link management platform with analytics and API for creating, managing, and tracking branded short links
Acciones disponibles (17)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Bulk Delete LinksDUB_BULK_DELETE_LINKSAcciónTool 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.
DUB_BULK_DELETE_LINKSAcciónTool 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.
Parámetros de entrada
link_idsstring[]ObligatorioList 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.
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Bulk Update LinksDUB_BULK_UPDATE_LINKSAcciónTool 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.
DUB_BULK_UPDATE_LINKSAcciónTool 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.
Parámetros de entrada
dataobjectObligatorioThe fields to update for all specified links.
linkIdsanyThe IDs of the links to update. Takes precedence over `externalIds`. Maximum 100 items.
externalIdsanyThe external IDs of the links to update as stored in your database. Maximum 100 items.
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create DomainDUB_CREATE_DOMAINAcciónTool 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.
DUB_CREATE_DOMAINAcciónTool 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.
Parámetros de entrada
logoanyThe logo of the domain
slugstringObligatorioName of the domain (e.g., yourbrand.com)
archivedanyWhether to archive this domain. False will unarchive a previously archived domain
assetLinksanyassetLinks.json configuration file (for deep link support on Android)
expiredUrlanyRedirect users to a specific URL when any link under this domain has expired
notFoundUrlanyRedirect users to a specific URL when a link under this domain doesn't exist
placeholderanyProvide context to your teammates in the link creation modal by showing them an example of a link to be shortened
appleAppSiteAssociationanyapple-app-site-association configuration file (for deep link support on iOS)
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create TagDUB_CREATE_TAGAcciónTool 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.
DUB_CREATE_TAGAcciónTool 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.
Parámetros de entrada
namestringObligatorioThe name of the tag to create. Must be between 1 and 50 characters.
coloranyThe color of the tag. If not provided, a random color will be assigned from the available options: red, yellow, green, blue, purple, brown, pink.
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete DomainDUB_DELETE_DOMAINAcciónTool 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.
DUB_DELETE_DOMAINAcciónTool 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.
Parámetros de entrada
slugstringObligatorioThe domain name to delete.
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete TagDUB_DELETE_TAGAcciónTool to delete a tag from Dub. Use when you need to remove a tag that is no longer needed.
DUB_DELETE_TAGAcciónTool to delete a tag from Dub. Use when you need to remove a tag that is no longer needed.
Parámetros de entrada
idstringObligatorioThe ID of the tag to delete.
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Link InfoDUB_GET_LINK_INFOAcciónTool 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.
DUB_GET_LINK_INFOAcciónTool 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.
Parámetros de entrada
keyanyThe key of the link to retrieve. E.g. for `d.to/github`, the key is `github`. Must be used together with domain parameter.
domainanyThe domain of the link to retrieve. E.g. for `d.to/github`, the domain is `d.to`. Must be used together with key parameter.
link_idanyThe unique ID of the short link.
external_idanyThis is the ID of the link in your database. Must be prefixed with 'ext_' when querying.
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get LinksDUB_GET_LINKSAcciónTool 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.
DUB_GET_LINKSAcciónTool 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.
Parámetros de entrada
pageanyThe page number for pagination.
sortanyDEPRECATED. Use `sort_by` instead.
tagIdanyDeprecated: Use `tag_ids` instead. The tag ID to filter the links by.
domainanyThe domain to filter the links by. E.g. `ac.me`. If not provided, all links for the workspace will be returned.
searchanyThe search term to filter the links by. The search term will be matched against the short link slug and the destination url.
sortByanyThe field to sort the links by. The default is `createdAt`.
tagIdsanyThe tag IDs to filter the links by.
userIdanyThe user ID to filter the links by.
folderIdanyThe folder ID to filter the links by.
pageSizeanyThe number of items per page.
tagNamesanyThe unique name of the tags assigned to the short link (case insensitive).
tenantIdanyThe ID of the tenant that created the link inside your system. If set, will only return links for the specified tenant.
withTagsanyDEPRECATED. Filter for links that have at least one tag assigned to them.
sortOrderanyThe sort order. The default is `desc`.
showArchivedanyWhether to include archived links in the response. Defaults to `false` if not provided.
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Links CountDUB_GET_LINKS_COUNTAcciónTool 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.
DUB_GET_LINKS_COUNTAcciónTool 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.
Parámetros de entrada
tagIdanyDeprecated: Use `tag_ids` instead. The tag ID to filter the links by.
domainanyThe domain to filter the links by. E.g. `ac.me`. If not provided, all links for the workspace will be returned.
searchanyThe search term to filter the links by. The search term will be matched against the short link slug and the destination url.
tagIdsanyThe tag IDs to filter the links by.
userIdanyThe user ID to filter the links by.
groupByanyThe field to group the links by.
folderIdanyThe folder ID to filter the links by.
tagNamesanyThe unique name of the tags assigned to the short link (case insensitive).
tenantIdanyThe ID of the tenant that created the link inside your system. If set, will only return links for the specified tenant.
withTagsanyDEPRECATED. Filter for links that have at least one tag assigned to them.
showArchivedanyWhether to include archived links in the response. Defaults to `false` if not provided.
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve List of TagsDUB_GET_TAGSAcciónTool 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.
DUB_GET_TAGSAcciónTool 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.
Parámetros de entrada
idsanyIDs of tags to filter by.
pageanyThe page number for pagination.
searchanyThe search term to filter the tags by.
sort_byanyThe field to sort the tags by.
page_sizeanyThe number of items per page.
sort_orderanyThe order to sort the tags by.
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get WorkspaceDUB_GET_WORKSPACEAcciónTool 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.
DUB_GET_WORKSPACEAcciónTool 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.
Parámetros de entrada
id_or_slugstringObligatorioThe ID or slug of the workspace.
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List DomainsDUB_LIST_DOMAINSAcciónTool 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.
DUB_LIST_DOMAINSAcciónTool 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.
Parámetros de entrada
pageanyThe page number for pagination.
searchanyThe search term to filter the domains by.
archivedanyWhether to include archived domains in the response. Defaults to false if not provided.
page_sizeanyThe number of items per page.
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Track Deep Link Open EventDUB_TRACK_OPENAcciónTool 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.
DUB_TRACK_OPENAcciónTool 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.
Parámetros de entrada
deep_linkanyThe 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
dub_domainanyYour 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
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update DomainDUB_UPDATE_DOMAINAcciónTool 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.
DUB_UPDATE_DOMAINAcciónTool 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.
Parámetros de entrada
logoanyThe logo of the domain (URL or data URI)
slugstringObligatorioThe domain name to update (e.g., 'acme.com'). This is the identifier of the domain you want to modify.
archivedanyWhether to archive this domain. Set to false to unarchive a previously archived domain
new_sluganyNew name of the domain if you want to rename it
asset_linksanyassetLinks.json configuration file (for deep link support on Android)
expired_urlanyRedirect users to a specific URL when any link under this domain has expired
placeholderanyProvide context to your teammates in the link creation modal by showing them an example of a link to be shortened
not_found_urlanyRedirect users to a specific URL when a link under this domain doesn't exist
apple_app_site_associationanyapple-app-site-association configuration file (for deep link support on iOS)
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update TagDUB_UPDATE_TAGAcciónTool to update an existing tag by ID. Use when you need to change the name or color of a tag.
DUB_UPDATE_TAGAcciónTool to update an existing tag by ID. Use when you need to change the name or color of a tag.
Parámetros de entrada
idstringObligatorioThe ID of the tag to update.
nameanyThe name of the tag to update.
coloranyThe color of the tag. Must be one of: red, yellow, green, blue, purple, brown, pink.
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update WorkspaceDUB_UPDATE_WORKSPACEAcciónTool to update workspace settings in Dub. Use when you need to modify workspace name, slug, logo, or conversion tracking settings.
DUB_UPDATE_WORKSPACEAcciónTool to update workspace settings in Dub. Use when you need to modify workspace name, slug, logo, or conversion tracking settings.
Parámetros de entrada
logoanyURL of the workspace logo image.
nameanyThe name of the workspace. Must be between 1 and 32 characters.
sluganyThe slug of the workspace. Must be between 3 and 48 characters.
id_or_slugstringObligatorioThe ID or slug of the workspace to update.
conversion_enabledanyWhether the workspace has conversion tracking enabled automatically for new links (d.to/conversions).
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Upsert a LinkDUB_UPSERT_LINKAcciónTool 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.
DUB_UPSERT_LINKAcciónTool 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.
Parámetros de entrada
geoanyGeo targeting information for the short link in JSON format `{[COUNTRY]: https://example.com }`. See https://d.to/geo for more information
iosanyThe iOS destination URL for the short link for iOS device targeting
keyanyThe short link slug. If not provided, a random 7-character slug will be generated
refanyThe referral tag of the short link. If set, this will populate or override the `ref` query parameter in the destination URL
urlstringObligatorioThe destination URL of the short link
imageanyThe custom link preview image (og:image). Will be used for Custom Link Previews if `proxy` is true. Learn more: https://d.to/og
proxyanyWhether the short link uses Custom Link Previews feature. Defaults to `false` if not provided
tagIdanyDeprecated: Use `tagIds` instead. The unique ID of the tag assigned to the short link
titleanyThe custom link preview title (og:title). Will be used for Custom Link Previews if `proxy` is true. Learn more: https://d.to/og
videoanyThe custom link preview video (og:video). Will be used for Custom Link Previews if `proxy` is true. Learn more: https://d.to/og
domainanyThe 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)
prefixanyThe 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
tagIdsanyThe unique IDs of the tags assigned to the short link. Can be a single tag ID string or an array of tag IDs
androidanyThe Android destination URL for the short link for Android device targeting
doIndexanyAllow search engines to index your short link. Defaults to `false` if not provided. Learn more: https://d.to/noindex
rewriteanyWhether the short link uses link cloaking. Defaults to `false` if not provided
archivedanyWhether the short link is archived. Defaults to `false` if not provided
commentsanyThe comments for the short link
folderIdanyThe unique ID existing folder to assign the short link to
passwordanyThe password required to access the destination URL of the short link
tagNamesanyThe 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
tenantIdanyThe ID of the tenant that created the link inside your system. If set, it can be used to fetch all links for a tenant
utm_termanyThe UTM term of the short link. If set, this will populate or override the UTM term in the destination URL
expiresAtanyThe date and time when the short link will expire at in ISO-8601 format
keyLengthanyThe 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`
partnerIdanyThe ID of the partner the short link is associated with
programIdanyThe ID of the program the short link is associated with
expiredUrlanyThe URL to redirect to when the short link has expired
externalIdanyThe 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
utm_mediumanyThe UTM medium of the short link. If set, this will populate or override the UTM medium in the destination URL
utm_sourceanyThe UTM source of the short link. If set, this will populate or override the UTM source in the destination URL
webhookIdsanyAn array of webhook IDs to trigger when the link is clicked. These webhooks will receive click event data
descriptionanyThe custom link preview description (og:description). Will be used for Custom Link Previews if `proxy` is true. Learn more: https://d.to/og
publicStatsanyDeprecated: Use `dashboard` instead. Whether the short link's stats are publicly accessible. Defaults to `false` if not provided
utm_contentanyThe UTM content of the short link. If set, this will populate or override the UTM content in the destination URL
testVariantsanyAn array of A/B test URLs and the percentage of traffic to send to each URL. Must have 2-4 variants
utm_campaignanyThe UTM campaign of the short link. If set, this will populate or override the UTM campaign in the destination URL
testStartedAtanyThe date and time when the tests started in ISO-8601 format
testCompletedAtanyThe date and time when the tests were or will be completed in ISO-8601 format
trackConversionanyWhether to track conversions for the short link. Defaults to `false` if not provided
Parámetros de salida
dataobjectObligatorioData from the action execution
erroranyError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not