How CloudSync Creates a Personalised Onboarding Link per Trial User

CloudSync's engineers call the SimpleURL API at signup to create a branded link per trial user, so onboarding emails and in-app nudges are trackable and on-brand.

SaaS Automation & API 7 min read

TL;DR

2,000Signups/mo automated via API
100%PII-free branded links
38%Email click-through rate

The problem: onboarding emails were invisible and looked suspicious

It was 9:15 on a Tuesday morning at CloudSync's Stockholm office, and Lisa Lindqvist was staring at a frustrating drop-off chart. More than 2,000 prospective customers—primarily IT directors at mid-market Nordic and German companies—started a free trial of CloudSync's enterprise file synchronization service every month. But by day four, nearly 65% of those trial accounts remained inactive, having never completed the initial client setup wizard.

Lisa had built an automated three-part onboarding sequence in Customer.io. It nudged administrators through three key milestones: running setup, inviting team leads, and installing the desktop app. However, she could not measure which emails drove clicks. The links inside those messages were long and messy, cluttered with tracking strings like https://cloudsync.io/setup?step=1&tenant_id=98124&utm_source=customerio&utm_campaign=onboarding_day1.

Some team members had tried generic public short links to keep buttons tidy. But enterprise security filters often flagged generic domains as spam risks, depressing click rates. Lisa needed clean, branded short links on get.cloudsync.io for every signup. Yet lead engineer Johan Berg refused to let marketing run manual batch scripts against production databases. Nor could developers spend their sprints making manual tracking links for thousands of weekly users.

What CloudSync needed

Automating onboarding tracking with the SimpleURL URL shortener API

1Provisioning the production API key

Johan opened his SimpleURL workspace settings. CloudSync uses the Pro plan, which allows up to 10,000 API requests per hour. This provided ample headroom for trial signups and staging tests. Under Settings → API Keys, Johan clicked Generate New API Key and copied the secret bearer token.

Following CloudSync security standards, Johan stored the token in their vault as SIMPLEURL_API_KEY. He configured their services to pass the key in the X-API-Key request header. CloudSync had already pointed DNS records for get.cloudsync.io with automatic SSL. The custom domain was ready for programmatic link creation immediately.

2Connecting Node.js to the REST endpoint during signup

Next, Johan added the link helper into CloudSync's Node.js signup pipeline. When an IT administrator registers on cloudsync.io, the backend triggers an event handler. Instead of running slow nightly batches, CloudSync creates short links instantly at registration.

To protect user privacy, Johan wrote a helper that generates an opaque HMAC token from the tenant ID. The application appends this token to the target URL. Node.js then sends an HTTP POST request to https://simpleurl.tech/api/v1/short-urls. The JSON payload specifies the target URL, the branded domain, and an internal description.

Figure 1: CloudSync's event pipeline creates an opaque, branded short URL during user registration and binds it to Customer.io profile attributes.
Code snippet: The Node.js implementation requires fewer than twenty lines of code using native fetch. By passing domain: "get.cloudsync.io", the link is provisioned on CloudSync's branded domain immediately, returning a short URL object in roughly 40 milliseconds.

3Syncing personalised URLs into Customer.io onboarding emails

Once SimpleURL returns the JSON payload, CloudSync stores the short link in Customer.io profile attributes. Johan created three attribute fields for the key onboarding milestones:

Because attributes bind to the customer record, Lisa designs emails using liquid merge tags. The email call-to-action button links to the user's unique short URL. No database primary keys appear in public. No user emails sit in query parameters. And no generic domains trigger corporate spam filters.

4Measuring milestone clicks and funnel progression

With the API live, Lisa tracked onboarding clicks directly in SimpleURL analytics. Instead of guessing email engagement, she saw exact click counts across all three sequence steps.

SimpleURL breaks down total clicks, unique clicks, and device types for each short link. Lisa saw that 71% of trial users opened the setup wizard. But drop-off was heavy at Step 2. Armed with click data, marketing revised email two and saw team invitations jump.

Figure 2: SimpleURL analytics panel tracking click engagement across each onboarding lifecycle email step.

The results: higher email engagement and zero engineering maintenance

Automating link creation with the SimpleURL REST API upgraded CloudSync's onboarding. Every trial email now includes clean, branded links that reinforce domain authority.

Because the helper runs on signup events, marketing can launch new email sequences without developer assistance. Enterprise IT buyers trust links on get.cloudsync.io. This drove a 13-percentage-point increase in setup completions.

Metric Before (Generic / Raw URLs) After (SimpleURL REST API)
Onboarding steps with click data 0 (Aggregated pageviews only) All 3 sequence steps tracked independently
Engineering time per email campaign update 3 hours (Dev ticket + review) 0 min (Marketing uses existing attributes)
Personal information exposed in URL strings Raw email strings & tenant IDs Zero (Opaque hash tokens & clean short slugs)
Welcome email click-through rate (CTR) 18% (Flagged by security filters) 38% (Trusted get.cloudsync.io domain)
Trial setup wizard completion rate 21% 34% (+13 percentage points)

Make it work for your SaaS team

If you manage SaaS signup flows, here is how to deploy dynamic links (see our dynamic links guide) and programmatic link creation:

FAQ

What is the rate limit for the SimpleURL REST API?

Rate limits scale by plan. Free includes 100 requests per hour, Hobby gives 1,000, Pro provides 10,000, and Team offers 50,000. Every API response includes X-RateLimit-Limit and X-RateLimit-Remaining headers to prevent throttling.

Can we specify our custom branded domain when creating short URLs via the API?

Yes. Pass the domain parameter in your POST payload (such as domain: "get.cloudsync.io"). SimpleURL creates the link on your branded domain with SSL encryption automatically.

Can we retrieve click analytics programmatically through the API?

Yes. SimpleURL offers a dedicated analytics endpoint at GET /api/v1/analytics/{keyword}. It returns total clicks, unique clicks, dates, countries, devices, and browsers for data warehouses.

What if we need no-code automation instead of a REST API?

Teams can also use no-code tools. Connect SimpleURL through our Zapier integration or Make.com integration to generate branded links from Airtable, Google Sheets, or CRM webhooks without code.

Automate branded links from your own backend

Integrate SimpleURL's REST API into your signup flow, lifecycle emails, and notification services in minutes.

Start your free trial View API plans
Dynamic links

One Link, Six Ad Platforms: How CloudSync Uses Dynamic Links for Clean Attribution

Branded domains

How CloudSync's Sales Team Uses Branded Links in Cold Outreach Sequences

Automation

How ThreadCraft Auto-Creates a Branded Link and QR Code for Every New Shopify SKU

Analytics

How City-Level Link Analytics Revealed CloudSync's Next Expansion Market

Get closer to your audience today

Your first Short Link & QR code is ready in under 60 seconds.

✓ Free 7-day trial (Extendable to 14)    ✓ Cancel anytime    ✓ 14-day money-back guarantee