Dub

Dub is an open-source link management platform for modern marketing teams. It provides powerful short link creation, analytics, and tracking capabilities with enterprise-grade infrastructure.

With the Dub integration in AACFlow, you can:

Create short links: Generate branded short links with custom domains, slugs, and UTM parameters
Upsert links: Create or update links idempotently by destination URL
Retrieve link info: Look up link details by ID, external ID, or domain + key combination
Update links: Modify destination URLs, metadata, UTM parameters, and link settings
Delete links: Remove short links by ID or external ID
List links: Search and filter links with pagination, sorting, and tag filtering
Get analytics: Retrieve click, lead, and sales analytics with grouping by time, geography, device, browser, referer, and more

In AACFlow, the Dub integration enables your agents to manage short links and track their performance programmatically. Use it to create trackable links as part of marketing workflows, monitor link engagement, and make data-driven decisions based on click analytics and conversion metrics.

Nutzungsanleitung

Create, manage, and track short links with Dub. Supports custom domains, UTM parameters, link analytics, and more.

Tools

`dub_create_link`

Create a new short link with Dub. Supports custom domains, slugs, UTM parameters, and more.

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Dub API key
`url`	string	Ja	The destination URL of the short link
`domain`	string	Nein	Custom domain for the short link (defaults to dub.sh)
`key`	string	Nein	Custom slug for the short link (randomly generated if not provided)
`externalId`	string	Nein	External ID for the link in your database
`tagIds`	string	Nein	Comma-separated tag IDs to assign to the link
`comments`	string	Nein	Comments for the short link
`expiresAt`	string	Nein	Expiration date in ISO 8601 format
`password`	string	Nein	Password to protect the short link
`rewrite`	boolean	Nein	Whether to enable link cloaking
`archived`	boolean	Nein	Whether to archive the link
`title`	string	Nein	Custom OG title for the link preview
`description`	string	Nein	Custom OG description for the link preview
`utm_source`	string	Nein	UTM source parameter
`utm_medium`	string	Nein	UTM medium parameter
`utm_campaign`	string	Nein	UTM campaign parameter
`utm_term`	string	Nein	UTM term parameter
`utm_content`	string	Nein	UTM content parameter

Ausgabe

Parameter	Typ	Beschreibung
`id`	string	Unique ID of the created link
`domain`	string	Domain of the short link
`key`	string	Slug of the short link
`url`	string	Destination URL
`shortLink`	string	Full short link URL
`qrCode`	string	QR code URL for the short link
`archived`	boolean	Whether the link is archived
`externalId`	string	External ID
`title`	string	OG title
`description`	string	OG description
`tags`	json	Tags assigned to the link (id, name, color)
`clicks`	number	Number of clicks
`leads`	number	Number of leads
`sales`	number	Number of sales
`saleAmount`	number	Total sale amount in cents
`lastClicked`	string	Last clicked timestamp
`createdAt`	string	Creation timestamp
`updatedAt`	string	Last update timestamp
`utm_source`	string	UTM source parameter
`utm_medium`	string	UTM medium parameter
`utm_campaign`	string	UTM campaign parameter
`utm_term`	string	UTM term parameter
`utm_content`	string	UTM content parameter

`dub_upsert_link`

Create or update a short link by its URL. If a link with the same URL already exists, update it. Otherwise, create a new link.

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Dub API key
`url`	string	Ja	The destination URL of the short link
`domain`	string	Nein	Custom domain for the short link (defaults to dub.sh)
`key`	string	Nein	Custom slug for the short link (randomly generated if not provided)
`externalId`	string	Nein	External ID for the link in your database
`tagIds`	string	Nein	Comma-separated tag IDs to assign to the link
`comments`	string	Nein	Comments for the short link
`expiresAt`	string	Nein	Expiration date in ISO 8601 format
`password`	string	Nein	Password to protect the short link
`rewrite`	boolean	Nein	Whether to enable link cloaking
`archived`	boolean	Nein	Whether to archive the link
`title`	string	Nein	Custom OG title for the link preview
`description`	string	Nein	Custom OG description for the link preview
`utm_source`	string	Nein	UTM source parameter
`utm_medium`	string	Nein	UTM medium parameter
`utm_campaign`	string	Nein	UTM campaign parameter
`utm_term`	string	Nein	UTM term parameter
`utm_content`	string	Nein	UTM content parameter

Ausgabe

Parameter	Typ	Beschreibung
`id`	string	Unique ID of the link
`domain`	string	Domain of the short link
`key`	string	Slug of the short link
`url`	string	Destination URL
`shortLink`	string	Full short link URL
`qrCode`	string	QR code URL for the short link
`archived`	boolean	Whether the link is archived
`externalId`	string	External ID
`title`	string	OG title
`description`	string	OG description
`tags`	json	Tags assigned to the link (id, name, color)
`clicks`	number	Number of clicks
`leads`	number	Number of leads
`sales`	number	Number of sales
`saleAmount`	number	Total sale amount in cents
`lastClicked`	string	Last clicked timestamp
`createdAt`	string	Creation timestamp
`updatedAt`	string	Last update timestamp
`utm_source`	string	UTM source parameter
`utm_medium`	string	UTM medium parameter
`utm_campaign`	string	UTM campaign parameter
`utm_term`	string	UTM term parameter
`utm_content`	string	UTM content parameter

`dub_get_link`

Retrieve information about a short link by its link ID, external ID, or domain + key combination.

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Dub API key
`linkId`	string	Nein	The unique ID of the short link
`externalId`	string	Nein	The external ID of the link in your database
`domain`	string	Nein	The domain of the link (use with key)
`key`	string	Nein	The slug of the link (use with domain)

Ausgabe

Parameter	Typ	Beschreibung
`id`	string	Unique ID of the link
`domain`	string	Domain of the short link
`key`	string	Slug of the short link
`url`	string	Destination URL
`shortLink`	string	Full short link URL
`qrCode`	string	QR code URL for the short link
`archived`	boolean	Whether the link is archived
`externalId`	string	External ID
`title`	string	OG title
`description`	string	OG description
`tags`	json	Tags assigned to the link (id, name, color)
`clicks`	number	Number of clicks
`leads`	number	Number of leads
`sales`	number	Number of sales
`saleAmount`	number	Total sale amount in cents
`lastClicked`	string	Last clicked timestamp
`createdAt`	string	Creation timestamp
`updatedAt`	string	Last update timestamp
`utm_source`	string	UTM source parameter
`utm_medium`	string	UTM medium parameter
`utm_campaign`	string	UTM campaign parameter
`utm_term`	string	UTM term parameter
`utm_content`	string	UTM content parameter

`dub_update_link`

Update an existing short link. You can modify the destination URL, slug, metadata, UTM parameters, and more.

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Dub API key
`linkId`	string	Ja	The link ID or external ID prefixed with ext_
`url`	string	Nein	New destination URL
`domain`	string	Nein	New custom domain
`key`	string	Nein	New custom slug
`title`	string	Nein	Custom OG title
`description`	string	Nein	Custom OG description
`externalId`	string	Nein	External ID for the link
`tagIds`	string	Nein	Comma-separated tag IDs
`comments`	string	Nein	Comments for the short link
`expiresAt`	string	Nein	Expiration date in ISO 8601 format
`password`	string	Nein	Password to protect the link
`rewrite`	boolean	Nein	Whether to enable link cloaking
`archived`	boolean	Nein	Whether to archive the link
`utm_source`	string	Nein	UTM source parameter
`utm_medium`	string	Nein	UTM medium parameter
`utm_campaign`	string	Nein	UTM campaign parameter
`utm_term`	string	Nein	UTM term parameter
`utm_content`	string	Nein	UTM content parameter

Ausgabe

Parameter	Typ	Beschreibung
`id`	string	Unique ID of the updated link
`domain`	string	Domain of the short link
`key`	string	Slug of the short link
`url`	string	Destination URL
`shortLink`	string	Full short link URL
`qrCode`	string	QR code URL for the short link
`archived`	boolean	Whether the link is archived
`externalId`	string	External ID
`title`	string	OG title
`description`	string	OG description
`tags`	json	Tags assigned to the link (id, name, color)
`clicks`	number	Number of clicks
`leads`	number	Number of leads
`sales`	number	Number of sales
`saleAmount`	number	Total sale amount in cents
`lastClicked`	string	Last clicked timestamp
`createdAt`	string	Creation timestamp
`updatedAt`	string	Last update timestamp
`utm_source`	string	UTM source parameter
`utm_medium`	string	UTM medium parameter
`utm_campaign`	string	UTM campaign parameter
`utm_term`	string	UTM term parameter
`utm_content`	string	UTM content parameter

`dub_delete_link`

Delete a short link by its link ID or external ID (prefixed with ext_).

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Dub API key
`linkId`	string	Ja	The link ID or external ID prefixed with ext_

Ausgabe

Parameter	Typ	Beschreibung
`id`	string	ID of the deleted link

`dub_list_links`

Retrieve a paginated list of short links for the authenticated workspace. Supports filtering by domain, search query, tags, and sorting.

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Dub API key
`domain`	string	Nein	Filter by domain
`search`	string	Nein	Search query matched against the short link slug and destination URL
`tagIds`	string	Nein	Comma-separated tag IDs to filter by
`showArchived`	boolean	Nein	Whether to include archived links (defaults to false)
`sortBy`	string	Nein	Sort by field: createdAt, clicks, saleAmount, or lastClicked
`sortOrder`	string	Nein	Sort order: asc or desc
`page`	number	Nein	Page number (default: 1)
`pageSize`	number	Nein	Number of links per page (default: 100, max: 100)

Ausgabe

Parameter	Typ	Beschreibung
`links`	json	Array of link objects (id, domain, key, url, shortLink, clicks, tags, createdAt)
`count`	number	Number of links returned

`dub_get_analytics`

Retrieve analytics for links including clicks, leads, and sales. Supports filtering by link, time range, and grouping by various dimensions.

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Dub API key
`event`	string	Nein	Event type: clicks (default), leads, sales, or composite
`groupBy`	string	Nein	Group results by: count (default), timeseries, countries, cities, devices, browsers, os, referers, top_links, top_urls
`linkId`	string	Nein	Filter by link ID
`externalId`	string	Nein	Filter by external ID (prefix with ext_)
`domain`	string	Nein	Filter by domain
`interval`	string	Nein	Time interval: 24h (default), 7d, 30d, 90d, 1y, mtd, qtd, ytd, or all
`start`	string	Nein	Start date/time in ISO 8601 format (overrides interval)
`end`	string	Nein	End date/time in ISO 8601 format (defaults to now)
`country`	string	Nein	Filter by country (ISO 3166-1 alpha-2 code)
`timezone`	string	Nein	IANA timezone for timeseries data (defaults to UTC)

Ausgabe

Parameter	Typ	Beschreibung
`clicks`	number	Total number of clicks
`leads`	number	Total number of leads
`sales`	number	Total number of sales
`saleAmount`	number	Total sale amount in cents
`data`	json	Grouped analytics data (timeseries, countries, devices, etc.)

On this page