Creating links at scale for SMS and campaigns

curl -X PUT https://enterprise-api.rebrandly.com/v1/links \
  -H "Content-Type: application/json" \
  -H "apikey: YOUR_API_KEY" \
  -H "workspace: YOUR_WORKSPACE_ID" \
  -d '[
    {
      "destination": "https://www.brandyour.link/product?ref=sms_001",
      "title": "SMS link 001",
      "ttl": 2592000
    },
    {
      "destination": "https://www.brandyour.link/product?ref=sms_002",
      "title": "SMS link 002",
      "ttl": 2592000
    }
  ]'

// Node.js—batch create high-volume links
const HIGH_VOLUME_API = "https://enterprise-api.rebrandly.com";
const API_KEY = process.env.REBRANDLY_API_KEY;
const WORKSPACE_ID = process.env.REBRANDLY_WORKSPACE_ID;

async function createCampaignLinks(links) {
  const response = await fetch(`${HIGH_VOLUME_API}/v1/links`, {
    method: "PUT",
    headers: {
      "Content-Type": "application/json",
      "apikey": API_KEY,
      "workspace": WORKSPACE_ID
    },
    body: JSON.stringify(links)
  });

  if (!response.ok) {
    throw new Error(`API error: ${response.status}`);
  }

  return response.json();
}

// Create a batch of 25 links — TTL set to 30 days (in seconds)
const TTL_30_DAYS = 30 * 24 * 60 * 60;
const batch = Array.from({ length: 25 }, (_, i) => ({
  destination: `https://www.brandyour.link/product?ref=sms_${String(i + 1).padStart(3, "0")}`,
  title: `SMS link ${i + 1}`,
  ttl: TTL_30_DAYS
}));

const createdLinks = await createCampaignLinks(batch);
console.log(`Created ${createdLinks.length} links`);

import os
import requests

HIGH_VOLUME_API = "https://enterprise-api.rebrandly.com"
API_KEY = os.environ["REBRANDLY_API_KEY"]
WORKSPACE_ID = os.environ["REBRANDLY_WORKSPACE_ID"]
HEADERS = {
    "Content-Type": "application/json",
    "apikey": API_KEY,
    "workspace": WORKSPACE_ID
}

TTL_30_DAYS = 30 * 24 * 60 * 60  # seconds

def create_campaign_links(links: list[dict]) -> list[dict]:
    response = requests.put(
        f"{HIGH_VOLUME_API}/v1/links",
        headers=HEADERS,
        json=links
    )
    response.raise_for_status()
    return response.json()

# Build a batch of 25 links
batch = [
    {
        "destination": f"https://www.brandyour.link/product?ref=sms_{str(i+1).zfill(3)}",
        "title": f"SMS link {i+1}",
        "ttl": TTL_30_DAYS
    }
    for i in range(25)
]

links = create_campaign_links(batch)
print(f"Created {len(links)} links")
for link in links:
    print(link["shortUrl"])

[
  {
    "id": "a1b2c3d4e5f6",
    "shortUrl": "rebrand.ly/abc001",
    "destination": "https://www.brandyour.link/product?ref=sms_001",
    "ttl": 2592000,
    "expiresAt": "2026-09-01T00:00:00.000Z",
    "ttlCapped": null,
    "status": "active"
  }
]

[
  {
    "id": "a1b2c3d4e5f6",
    "shortUrl": "rebrand.ly/abc001",
    "destination": "https://www.brandyour.link/product?ref=sms_001",
    "ttl": 7776000,
    "expiresAt": "2026-09-01T00:00:00.000Z",
    "ttlCapped": {
      "requestedValue": 31536000,
      "appliedValue": 7776000,
      "reason": "plan_max_exceeded"
    },
    "status": "active"
  }
]

// Node.js—rate-limited batch processor
function chunk(array, size) {
  const chunks = [];
  for (let i = 0; i < array.length; i += size) {
    chunks.push(array.slice(i, i + size));
  }
  return chunks;
}

function sleep(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}

async function createLinksAtScale(destinations, ttl) {
  const batches = chunk(destinations, 25);
  const allLinks = [];

  for (let i = 0; i < batches.length; i++) {
    const batch = batches[i];
    const links = batch.map((destination) => ({
      destination,
      ttl
    }));

    const created = await createCampaignLinks(links);
    allLinks.push(...created);

    // Respect default 1 req/sec rate limit
    if (i < batches.length - 1) {
      await sleep(1000);
    }
  }

  return allLinks;
}

// Generate one tracked link per SMS recipient
async function prepareSmsCampaign(recipients, campaignUrl, ttlSeconds) {
  const destinations = recipients.map(
    r => `${campaignUrl}?recipient_id=${r.id}&utm_source=sms`
  );

  const links = await createLinksAtScale(
    destinations,
    ttlSeconds
  );

  // Pair each recipient with their unique short link
  return recipients.map((r, i) => ({
    ...r,
    trackingUrl: links[i].shortUrl
  }));
}

// Example: campaign links expiring in 7 days
const TTL_7_DAYS = 7 * 24 * 60 * 60;
const campaignLinks = await prepareSmsCampaign(recipients, campaignUrl, TTL_7_DAYS);