Server-side SDKs

Client-side SDKs

Embedded Dashboards

Open-source client libraries for the Dub API

Overview

Dub Documentation

Dub is the modern link attribution platform for you to create short links, track conversion analytics, and run affiliate programs.

Introduction

Learn how to use Dub's links to track and analyze your marketing campaigns.

Links API – Introduction

Learn how to perform bulk operations on links.

Bulk operations

Learn how to associate links with users, campaigns, teams, and other entities within your system.

Organizing links

Learn how to use Dub's Analytics API to build real-time analytics dashboards for your links.

Analytics API – Introduction

Learn how to set up your referral/affiliate program with Dub Partners.

Dub Partners – Quickstart

Quickstart

Learn how to create a white-labeled referral dashboard with Dub Partners.

White-labeling

Integrate Dub with your favorite tools and services.

Dub Integrations: Connect Dub to tools and services

Learn how to authenticate users with OAuth 2.0. for your Dub integration.

Build your own integration

A guide on how to run Dub's codebase locally.

How to setup Dub for Local Development (6 steps)

Local development

An end-to-end guide on how to self-host Dub – the open-source link attribution platform.

How to self-host Dub in 8 easy steps

Self-hosting Dub

Dub API Reference - Introduction

API keys

What are Dub's API rate limits?

Rate limits

Dub is the link management platform for modern marketing teams.

Getting Started with Dub - Documentation

A quick overview of how Dub is structured.

Data model

Explore ideas and examples of what you can build with the Dub API

Dub API Examples - Build with the Dub API

Examples

Learn how to perform bulk actions on links.

Bulk actions

Learn how to use Dub's analytics to track and analyze your link performance.

Analytics

Use webhooks to get real-time notifications on events happening across your Dub workspace.

List of available webhook events you can listen to along with their payload examples

Event types

Learn how to verify webhook requests to ensure they're coming from Dub.

Verify webhook requests

Learn how to get started with Dub Conversions

Dub Conversions Quickstart

Learn how to track lead conversion events with Dub Conversions

How to track lead events with Dub Conversions

Learn how to track lead conversion events with Clerk and Dub

Clerk Lead Tracking – Dub Conversions

Clerk

Learn how to track lead conversion events with NextAuth.js and Dub

NextAuth.js Lead Tracking – Dub Conversions

NextAuth.js

Learn how to track lead conversion events with Supabase and Dub

Supabase Lead Tracking – Dub Conversions

Supabase

Learn how to track lead conversion events with Auth0 and Dub

Auth0 Lead Tracking – Dub Conversions

Auth0

Learn how to track lead conversion events with Appwrite and Dub

Appwrite Lead Tracking – Dub Conversions

Appwrite

Learn how to track sales conversion events with Dub Conversions

How to track sale events with Dub Conversions

Learn how to track a sale conversion event with Stripe

How to track sale conversions with Stripe and Dub Conversions

Stripe

Learn how to track a sale conversion event with Shopify

How to track sale conversions with Shopify and Dub Conversions

Shopify

Learn how to set up Dub OAuth applications to authenticate users with OAuth 2.0.

Integrate with Dub

Integrate Dub's link management infrastructure with Zapier.

Dub + Zapier integration

Zapier

Integrate Dub's link management infrastructure with Make.com.

Dub + Make.com integration

Make.com

Integrate Dub's link management infrastructure with Stripe.

Dub + Stripe integration

Integrate Dub's link management infrastructure with Shopify.

Dub + Shopify integration

Integrate Dub's link management infrastructure with Segment.

Dub + Segment integration

Segment

Integrate Dub's link management infrastructure with WordPress.

Dub + WordPress integration

WordPress

Integrate Dub's link management infrastructure with Raycast.

Dub + Raycast integration

Raycast

Integrate Dub's link management infrastructure with Slack.

Dub + Slack integration

Slack

Local Development

An end-to-end guide on how to self-host Dub – the open-source link management platform.

API Keys

Learn how to paginate through resources in the API.

All endpoints that list resources support pagination.

Pagination

Troubleshoot problems with this comprehensive breakdown of all error codes.

Dub API returns machine readable error codes, human readable error messages and a link to the docs for more information

Errors

Create a new link for the authenticated workspace.

Create a new link with the Dub API - API Reference

Create a new link

Update a link for the authenticated workspace. If there's no change, returns it as it is.

Update a link with the Dub API - API Reference

Update a link

Upsert a link for the authenticated workspace by its URL. If a link with the same URL already exists, return it (or update it if there are any changes). Otherwise, a new link will be created.

Upsert a link with the Dub API - API Reference

Upsert a link

Delete a link for the authenticated workspace.

Delete a link with the Dub API - API Reference

Delete a link

Get link info with the Dub API - API Reference

Retrieve a link

Retrieve a paginated list of links for the authenticated workspace.

Get list of links with the Dub API - API Reference

Retrieve a list of links

Retrieve the number of links for the authenticated workspace. The provided query parameters allow filtering the returned links.

Get the links count with the Dub API - API Reference

Retrieve links count

Bulk create up to 100 links for the authenticated workspace.

Bulk create links with the Dub API - API Reference

Bulk create links

Bulk update up to 100 links with the same data for the authenticated workspace.

Bulk update links with the Dub API - API Reference

Bulk update links

Bulk delete up to 100 links for the authenticated workspace.

Bulk delete links with the Dub API - API Reference

Bulk delete links

Get a QR code with the Dub API - API Reference

Retrieve a QR code

Retrieve analytics for a link, a domain, or the authenticated workspace. The response type depends on the `event` and `type` query parameters.

Retrieve analytics for a link, a domain, or the authenticated workspace. - API Reference

Retrieve analytics

Retrieve a paginated list of events for the authenticated workspace.

Retrieve a list of events with the Dub API - API Reference

Retrieve a list of events

Track a lead with the Dub API - API Reference

Track a lead

Track a sale with the Dub API - API Reference

Track a sale

Retrieve a customer by ID for the authenticated workspace.

Retrieve a customer with the Dub API - API Reference

Retrieve a customer

Retrieve a list of customers for the authenticated workspace.

Retrieve a list of customers with the Dub API - API Reference

Retrieve a list of customers

Update a customer for the authenticated workspace.

Update a customer with the Dub API - API Reference

Update a customer

Delete a customer with the Dub API - API Reference

Delete a customer

Create a new partner for a program. If partner exists, automatically enrolls them.

Create a new partner

Create a new link for a partner that is enrolled in your program.

Create a link for a partner

Upsert a link for a partner that is enrolled in your program. If a link with the same URL already exists, return it (or update it if there are any changes). Otherwise, a new link will be created.

Upsert a link for a partner

Retrieve a partner's links by their partner ID or tenant ID.

Retrieve a partner's links

Retrieve a partner's links.

Retrieve analytics for a partner within a program. The response type vary based on the `groupBy` query parameter.

Retrieve analytics for a partner

Create a new tag for the authenticated workspace.

Create a new tag with the Dub API - API Reference

Create a new tag

Retrieve a list of tags for the authenticated workspace.

Get list of tags with the Dub API - API Reference

Retrieve a list of tags

Update a tag with the Dub API - API Reference

Update a tag

Create a domain for the authenticated workspace.

Create a domain for a workspace with the Dub API - API Reference

Create a domain

Update a domain for the authenticated workspace.

Update a domain with the Dub API - API Reference

Update a domain

Delete a domain from a workspace. It cannot be undone. This will also delete all the links associated with the domain.

Delete a domain from the workspace with the Dub API - API Reference

Delete a domain

Retrieve a list of domains associated with the authenticated workspace.

Overview

SDKs

APIs

Overview

Server-side SDKs

TypeScript

Go

Python

Ruby

PHP

Client-side SDKs

@dub/analytics

Embedded Dashboards

Referrals Embed

CLI

Dub CLI

Overview

SDKs

APIs

​Server-side SDKs

TypeScript

Go

Python

Ruby

PHP

​Client-side SDKs

@dub/analytics

​Embedded Dashboards

Referrals Embed

​CLI

Dub CLI

Server-side SDKs

Client-side SDKs

Embedded Dashboards

CLI