Introduction to short links

Links are the bread and butter of RevRoute .

Everything on RevRoute starts with a link. Whether you’re creating:

• a handful of links for your marketing campaign
• hundreds of links for your affiliate program 
• thousands of links, created programmatically, for your SMS campaign

In this guide, we’ll cover the link model, how to create links, and more.

The link model

The link model consists of the following properties:

For more advanced features — conversion tracking, tags and folders, bulk operations — see the guides linked from this page.

Create a link

The url field, representing the destination URL, is the sole mandatory parameter required for the creation of a new short link.

import { RevRoute } from "dub";
 
export const dub = new RevRoute({
  token: process.env.REVROUTE_API_KEY,
});
 
const link = await dub.links.create({
  url: "https://google.com",
});

Update a link

An existing link can be updated by providing the id to the update method. This method returns the updated link as a response.

You can use either the linkId or an externalId prefixed with ext_ which is a unique identifier for the link in your own database to associate it with the link in RevRoute’s system.

import { RevRoute } from "dub";
 
export const dub = new RevRoute({
  token: process.env.REVROUTE_API_KEY,
});
 
const link = await dub.links.update("link_1KJ1H3PZGE081A22TC6PTQYJP", {
  url: "https://www.google.uk", // new URL
});

Upsert a link

Upserting a link is a combination of creating and updating a link. 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.

This allows you to use the upsert method without the necessity of checking for the link’s existence beforehand.

import { RevRoute } from "dub";
 
export const dub = new RevRoute({
  token: process.env.REVROUTE_API_KEY,
});
 
const link = await dub.links.upsert({
  url: "https://google.com", // will always be the same short link
});