How CloudSync's Backend Creates a Personalised Onboarding Link for Every Trial User

The problem: onboarding emails had zero visibility and looked suspicious to IT buyers

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 inside Customer.io to nudge administrators through the critical activation milestones: launching the setup wizard, inviting their team leads, and installing the desktop synchronization agent. However, she had no trustworthy way to measure which email nudges were actually driving clicks. The links inside those automated messages were messy, long URLs appended with multiple analytics tracking strings, such as https://cloudsync.io/setup?step=1&tenant_id=98124&utm_source=customerio&utm_campaign=onboarding_day1.

To make matters worse, some team members had experimented with generic public short links to make the calls to action shorter. But enterprise IT security gateways frequently flagged generic shortener domains as spam risks, depressing click-through rates. Lisa needed clean, branded short links on get.cloudsync.io for every single signup. Yet Johan Berg, CloudSync's lead backend engineer, understandably refused to let marketing run manual batch scripts against production databases, nor could developers spend their sprints generating manual tracking links for thousands of weekly users.

What CloudSync needed

• A developer-friendly URL shortener API: A robust REST endpoint that generates shortened URLs programmatically in milliseconds during the trial signup event.
• Enforced branded domain ownership: Every short link had to resolve under get.cloudsync.io so enterprise IT buyers would trust the link in their inboxes.
• Zero personal information in public links: Public URLs had to remain completely opaque, avoiding exposed user emails, customer names, or raw internal database IDs.
• Automated variable sync with Customer.io: Newly generated links needed to feed directly into user attributes so lifecycle email campaigns could merge them without developer intervention.
• Independent click analytics: Direct visibility into click volume across each onboarding step to verify how many administrators progressed through the setup funnel.

Automating onboarding tracking with the SimpleURL URL shortener API

1Provisioning the production API key

Johan began by accessing the SimpleURL workspace settings. CloudSync runs on the Pro plan, which provides up to 10,000 API requests per hour—providing plenty of capacity for their monthly trial volume and automated staging tests. Under Settings → API Keys, Johan clicked Generate New API Key and copied the secret bearer token.

Following CloudSync's security standards, Johan stored the token inside their production secret vault as SIMPLEURL_API_KEY. He configured the service to supply the credential inside the standard X-API-Key request header. Because CloudSync had already configured DNS records for get.cloudsync.io with automatic SSL provisioning, the custom domain was immediately available for programmatic link creation.

2Connecting Node.js to the REST endpoint during signup

Next, Johan integrated the link creation helper into CloudSync's Node.js authentication and signup pipeline. Whenever a new IT administrator completes the trial registration form on cloudsync.io, the backend triggers an asynchronous event handler. Rather than generating links in cumbersome nightly batches, CloudSync constructs them instantly at registration time.

To protect customer privacy, Johan wrote a lightweight helper that computes an opaque, HMAC-derived verification token from the user's tenant identifier. This token is appended to the setup wizard target URL. The Node.js application then sends an HTTP POST request to SimpleURL's https://simpleurl.tech/api/v1/short-urls endpoint with a structured JSON payload specifying the target URL, the custom branded domain, and an internal description.

CloudSync Automated Onboarding Architecture Zero PII · Event-Driven Lifecycle

1. Signup Trigger Trial Registered

user.signed_up

2. Node.js Worker Generates Token

HMAC hash ref

3. SimpleURL API POST /short-urls

get.cloudsync.io/w7x9k2

4. Customer.io Lifecycle Email

setup_wizard_url

Payload Destination: https://cloudsync.io/setup?step=1&ref=d7a9b1c4e2 → get.cloudsync.io/w7x9k2

3Syncing personalised URLs into Customer.io onboarding emails

Once SimpleURL returns the JSON response, CloudSync's worker stores the resulting short link directly into the user's profile attribute set within Customer.io. Johan established three distinct attribute fields corresponding to the primary milestones in CloudSync's trial journey:

• onboarding_step1_url: Links directly to the web setup wizard with the trial token (get.cloudsync.io/w7x9k2).
• onboarding_step2_url: Directs administrators to the team invitation portal (get.cloudsync.io/t4m8p1).
• onboarding_step3_url: Directs users to download the desktop synchronization software (get.cloudsync.io/d3k7s9).

Because these attributes are bound dynamically to the customer record, Lisa can design clean emails in Customer.io using simple liquid merge tags. The email call-to-action button simply points to the user's unique short link. There are no exposed database primary keys, no personal email strings in the URL parameters, and no generic third-party domains to trigger corporate firewalls.

4Measuring milestone clicks and funnel progression

With the API integration running smoothly, Lisa could finally measure onboarding behavior directly inside SimpleURL's analytics dashboard. Instead of guessing how many trial accounts clicked through each lifecycle email, she could evaluate exact click engagement across all three sequence steps.

SimpleURL displays total clicks, unique clicks, and device types broken down by short link. Lisa discovered that while 71% of trial users clicked the initial setup wizard email, drop-off was concentrated at Step 2 (inviting team members). Armed with real click data, marketing updated the copy for email two and saw team invitations jump significantly.

The results: higher email engagement and zero engineering maintenance

Automating link creation through the SimpleURL REST API transformed CloudSync's trial onboarding experience. Instead of sending generic links or unformatted URLs with unwieldy tracking parameters, every trial email now features clean, branded links that reinforce CloudSync's domain authority.

Because Johan built a reusable helper that connects directly to the signup event, marketing can introduce new email sequences or in-app nudges without requesting engineering resources. Most importantly, enterprise IT directors readily click branded links on get.cloudsync.io, driving an overall 13-percentage-point increase in trial onboarding completions.

Make it work for your SaaS team

If you manage SaaS signup flows or automated user onboarding, here is how you can implement programmatic link generation effectively:

• Never expose personal information in URL paths: Avoid passing customer email addresses, real names, or internal database primary keys in short link queries. Use an opaque reference token or salted hash that your backend validates upon destination redirect.
• Generate links at the event, not in batch scripts: Calling the SimpleURL REST API directly inside your signup event handler takes under 50 milliseconds. This ensures lifecycle emails dispatch immediately with the correct personalised link rather than waiting for an overnight batch job.
• Include informative descriptions in API payloads: When calling POST /api/v1/short-urls, populate the description property (such as "Trial Onboarding Step 1"). This allows non-technical team members to identify and filter campaigns inside the SimpleURL web dashboard.
• Implement an asynchronous error fallback: Wrap your API call inside an asynchronous helper with standard error handling. If a temporary network interruption occurs, fall back gracefully to your canonical destination URL so user account creation and email delivery are never delayed.
• Monitor rate limits via response headers: Check the returned X-RateLimit-Remaining header during high-volume periods. SimpleURL's Pro tier provides 10,000 requests per hour, which supports high-velocity product launches and marketing surges.

FAQ

What is the rate limit for the SimpleURL REST API?

Rate limits scale according to your active subscription plan. The Free tier includes 100 requests per hour, the Hobby plan provides 1,000 requests per hour, the Pro plan offers 10,000 requests per hour, and the Team plan delivers 50,000 requests per hour. Every API response includes X-RateLimit-Limit and X-RateLimit-Remaining headers to help your backend avoid throttling.

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

Yes. By specifying the domain parameter in your POST payload (for example, domain: "get.cloudsync.io"), SimpleURL provisions the link directly on your connected branded domain. This ensures that every programmatic link preserves your corporate branding and SSL encryption.

Can we retrieve click analytics programmatically through the API?

Yes. In addition to creating short links, SimpleURL provides a dedicated analytics endpoint at GET /api/v1/analytics/{keyword}. This endpoint returns total clicks, unique clicks, dates, countries, devices, and browsers, making it easy to pull click metrics into your internal data warehouse or product analytics dashboard.

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

Teams that prefer no-code workflows can achieve similar automation using SimpleURL's native integrations. You can connect SimpleURL via our Zapier integration or our Make.com integration to automatically create branded links from tools like Airtable, Google Sheets, or CRM webhooks without writing custom backend code.

Related use cases