NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Dub

dub

Short link management platform with analytics and API for creating, managing, and tracking branded short links

URL ShortenerAnalyticsWeb del proveedor
Acciones
17
Triggers
0
Autenticación
—
OAuth gestionado
Sí
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

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ón

Tool 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[]Obligatorio

    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.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Bulk Update LinksDUB_BULK_UPDATE_LINKSAcción

Tool 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

  • dataobjectObligatorio

    The fields to update for all specified links.

  • linkIdsany

    The IDs of the links to update. Takes precedence over `externalIds`. Maximum 100 items.

  • externalIdsany

    The external IDs of the links to update as stored in your database. Maximum 100 items.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create DomainDUB_CREATE_DOMAINAcción

Tool 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

  • logoany

    The logo of the domain

  • slugstringObligatorio

    Name of the domain (e.g., yourbrand.com)

  • archivedany

    Whether to archive this domain. False will unarchive a previously archived domain

  • assetLinksany

    assetLinks.json configuration file (for deep link support on Android)

  • expiredUrlany

    Redirect users to a specific URL when any link under this domain has expired

  • notFoundUrlany

    Redirect users to a specific URL when a link under this domain doesn't exist

  • placeholderany

    Provide context to your teammates in the link creation modal by showing them an example of a link to be shortened

  • appleAppSiteAssociationany

    apple-app-site-association configuration file (for deep link support on iOS)

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create TagDUB_CREATE_TAGAcción

Tool 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

  • namestringObligatorio

    The name of the tag to create. Must be between 1 and 50 characters.

  • colorany

    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.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete DomainDUB_DELETE_DOMAINAcción

Tool 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

  • slugstringObligatorio

    The domain name to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete TagDUB_DELETE_TAGAcción

Tool to delete a tag from Dub. Use when you need to remove a tag that is no longer needed.

Parámetros de entrada

  • idstringObligatorio

    The ID of the tag to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Link InfoDUB_GET_LINK_INFOAcción

Tool 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

  • keyany

    The key of the link to retrieve. E.g. for `d.to/github`, the key is `github`. Must be used together with domain parameter.

  • domainany

    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.

  • link_idany

    The unique ID of the short link.

  • external_idany

    This is the ID of the link in your database. Must be prefixed with 'ext_' when querying.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get LinksDUB_GET_LINKSAcción

Tool 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

  • pageany

    The page number for pagination.

  • sortany

    DEPRECATED. Use `sort_by` instead.

  • tagIdany

    Deprecated: Use `tag_ids` instead. The tag ID to filter the links by.

  • domainany

    The domain to filter the links by. E.g. `ac.me`. If not provided, all links for the workspace will be returned.

  • searchany

    The search term to filter the links by. The search term will be matched against the short link slug and the destination url.

  • sortByany

    The field to sort the links by. The default is `createdAt`.

  • tagIdsany

    The tag IDs to filter the links by.

  • userIdany

    The user ID to filter the links by.

  • folderIdany

    The folder ID to filter the links by.

  • pageSizeany

    The number of items per page.

  • tagNamesany

    The unique name of the tags assigned to the short link (case insensitive).

  • tenantIdany

    The ID of the tenant that created the link inside your system. If set, will only return links for the specified tenant.

  • withTagsany

    DEPRECATED. Filter for links that have at least one tag assigned to them.

  • sortOrderany

    The sort order. The default is `desc`.

  • showArchivedany

    Whether to include archived links in the response. Defaults to `false` if not provided.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Links CountDUB_GET_LINKS_COUNTAcción

Tool 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

  • tagIdany

    Deprecated: Use `tag_ids` instead. The tag ID to filter the links by.

  • domainany

    The domain to filter the links by. E.g. `ac.me`. If not provided, all links for the workspace will be returned.

  • searchany

    The search term to filter the links by. The search term will be matched against the short link slug and the destination url.

  • tagIdsany

    The tag IDs to filter the links by.

  • userIdany

    The user ID to filter the links by.

  • groupByany

    The field to group the links by.

  • folderIdany

    The folder ID to filter the links by.

  • tagNamesany

    The unique name of the tags assigned to the short link (case insensitive).

  • tenantIdany

    The ID of the tenant that created the link inside your system. If set, will only return links for the specified tenant.

  • withTagsany

    DEPRECATED. Filter for links that have at least one tag assigned to them.

  • showArchivedany

    Whether to include archived links in the response. Defaults to `false` if not provided.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Retrieve List of TagsDUB_GET_TAGSAcción

Tool 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

  • idsany

    IDs of tags to filter by.

  • pageany

    The page number for pagination.

  • searchany

    The search term to filter the tags by.

  • sort_byany

    The field to sort the tags by.

  • page_sizeany

    The number of items per page.

  • sort_orderany

    The order to sort the tags by.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get WorkspaceDUB_GET_WORKSPACEAcción

Tool 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_slugstringObligatorio

    The ID or slug of the workspace.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List DomainsDUB_LIST_DOMAINSAcción

Tool 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

  • pageany

    The page number for pagination.

  • searchany

    The search term to filter the domains by.

  • archivedany

    Whether to include archived domains in the response. Defaults to false if not provided.

  • page_sizeany

    The number of items per page.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Track Deep Link Open EventDUB_TRACK_OPENAcción

Tool 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_linkany

    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

  • dub_domainany

    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

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update DomainDUB_UPDATE_DOMAINAcción

Tool 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

  • logoany

    The logo of the domain (URL or data URI)

  • slugstringObligatorio

    The domain name to update (e.g., 'acme.com'). This is the identifier of the domain you want to modify.

  • archivedany

    Whether to archive this domain. Set to false to unarchive a previously archived domain

  • new_slugany

    New name of the domain if you want to rename it

  • asset_linksany

    assetLinks.json configuration file (for deep link support on Android)

  • expired_urlany

    Redirect users to a specific URL when any link under this domain has expired

  • placeholderany

    Provide context to your teammates in the link creation modal by showing them an example of a link to be shortened

  • not_found_urlany

    Redirect users to a specific URL when a link under this domain doesn't exist

  • apple_app_site_associationany

    apple-app-site-association configuration file (for deep link support on iOS)

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update TagDUB_UPDATE_TAGAcción

Tool to update an existing tag by ID. Use when you need to change the name or color of a tag.

Parámetros de entrada

  • idstringObligatorio

    The ID of the tag to update.

  • nameany

    The name of the tag to update.

  • colorany

    The color of the tag. Must be one of: red, yellow, green, blue, purple, brown, pink.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update WorkspaceDUB_UPDATE_WORKSPACEAcción

Tool to update workspace settings in Dub. Use when you need to modify workspace name, slug, logo, or conversion tracking settings.

Parámetros de entrada

  • logoany

    URL of the workspace logo image.

  • nameany

    The name of the workspace. Must be between 1 and 32 characters.

  • slugany

    The slug of the workspace. Must be between 3 and 48 characters.

  • id_or_slugstringObligatorio

    The ID or slug of the workspace to update.

  • conversion_enabledany

    Whether the workspace has conversion tracking enabled automatically for new links (d.to/conversions).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Upsert a LinkDUB_UPSERT_LINKAcción

Tool 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

  • geoany

    Geo targeting information for the short link in JSON format `{[COUNTRY]: https://example.com }`. See https://d.to/geo for more information

  • iosany

    The iOS destination URL for the short link for iOS device targeting

  • keyany

    The short link slug. If not provided, a random 7-character slug will be generated

  • refany

    The referral tag of the short link. If set, this will populate or override the `ref` query parameter in the destination URL

  • urlstringObligatorio

    The destination URL of the short link

  • imageany

    The custom link preview image (og:image). Will be used for Custom Link Previews if `proxy` is true. Learn more: https://d.to/og

  • proxyany

    Whether the short link uses Custom Link Previews feature. Defaults to `false` if not provided

  • tagIdany

    Deprecated: Use `tagIds` instead. The unique ID of the tag assigned to the short link

  • titleany

    The custom link preview title (og:title). Will be used for Custom Link Previews if `proxy` is true. Learn more: https://d.to/og

  • videoany

    The custom link preview video (og:video). Will be used for Custom Link Previews if `proxy` is true. Learn more: https://d.to/og

  • domainany

    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)

  • prefixany

    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

  • tagIdsany

    The unique IDs of the tags assigned to the short link. Can be a single tag ID string or an array of tag IDs

  • androidany

    The Android destination URL for the short link for Android device targeting

  • doIndexany

    Allow search engines to index your short link. Defaults to `false` if not provided. Learn more: https://d.to/noindex

  • rewriteany

    Whether the short link uses link cloaking. Defaults to `false` if not provided

  • archivedany

    Whether the short link is archived. Defaults to `false` if not provided

  • commentsany

    The comments for the short link

  • folderIdany

    The unique ID existing folder to assign the short link to

  • passwordany

    The password required to access the destination URL of the short link

  • tagNamesany

    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

  • tenantIdany

    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

  • utm_termany

    The UTM term of the short link. If set, this will populate or override the UTM term in the destination URL

  • expiresAtany

    The date and time when the short link will expire at in ISO-8601 format

  • keyLengthany

    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`

  • partnerIdany

    The ID of the partner the short link is associated with

  • programIdany

    The ID of the program the short link is associated with

  • expiredUrlany

    The URL to redirect to when the short link has expired

  • externalIdany

    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

  • utm_mediumany

    The UTM medium of the short link. If set, this will populate or override the UTM medium in the destination URL

  • utm_sourceany

    The UTM source of the short link. If set, this will populate or override the UTM source in the destination URL

  • webhookIdsany

    An array of webhook IDs to trigger when the link is clicked. These webhooks will receive click event data

  • descriptionany

    The custom link preview description (og:description). Will be used for Custom Link Previews if `proxy` is true. Learn more: https://d.to/og

  • publicStatsany

    Deprecated: Use `dashboard` instead. Whether the short link's stats are publicly accessible. Defaults to `false` if not provided

  • utm_contentany

    The UTM content of the short link. If set, this will populate or override the UTM content in the destination URL

  • testVariantsany

    An array of A/B test URLs and the percentage of traffic to send to each URL. Must have 2-4 variants

  • utm_campaignany

    The UTM campaign of the short link. If set, this will populate or override the UTM campaign in the destination URL

  • testStartedAtany

    The date and time when the tests started in ISO-8601 format

  • testCompletedAtany

    The date and time when the tests were or will be completed in ISO-8601 format

  • trackConversionany

    Whether to track conversions for the short link. Defaults to `false` if not provided

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not