TL;DR
- CloudSync's Node.js backend invokes the SimpleURL URL shortener API (
POST /api/v1/short-urls) immediately when an IT administrator starts a product trial. - Each trial user receives unique, branded links on get.cloudsync.io for each onboarding milestone without exposing raw database IDs or personal email addresses.
- Onboarding emails sent through Customer.io achieve a 38% click-through rate, delivering measurable funnel analytics while protecting corporate domain reputation.
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
- A developer-friendly URL shortener API: A REST endpoint that creates shortened URLs in milliseconds during signup.
- Branded custom domain ownership: Every short link resolves under get.cloudsync.io, earning trust from enterprise buyers.
- Zero personal data in public links: Public URLs remain completely opaque, hiding user emails and database IDs.
- Automated variable sync with Customer.io: Generated links feed into profile attributes so lifecycle emails merge them automatically.
- Independent click analytics: Direct insight into click counts across each onboarding step to track funnel drop-off.
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.
user.signed_up
HMAC hash ref
get.cloudsync.io/w7x9k2
setup_wizard_url
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:
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 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.
Onboarding Funnel Analytics · Last 30 Days
Campaign: Trial Activation Sequence
Milestone Performance
/w7x9k2)
1,520 clicks · 71% CTR
/t4m8p1)
1,028 clicks · 48% CTR
/d3k7s9)
792 clicks · 37% CTR
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:
- Never expose personal data in URL paths: Avoid customer emails, names, or database IDs in links. Use an opaque reference token that your backend validates upon destination redirect.
- Create links on events, not in batch scripts: Calling the SimpleURL API inside signup handlers takes under 50 milliseconds. Emails dispatch right away without waiting for nightly jobs.
- Add descriptive tags in API payloads: Populate the
descriptionfield in POST requests. This helps team members filter and manage links in the dashboard. - Implement an asynchronous error fallback: Wrap API calls in an error handler. If a network blip occurs, fall back to the canonical URL so account creation never stalls.
- Monitor rate limits in response headers: Check the
X-RateLimit-Remainingheader during surges. The Pro tier offers 10,000 requests per hour for high-velocity growth.
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 plansRelated use cases
One Link, Six Ad Platforms: How CloudSync Uses Dynamic Links for Clean Attribution
Branded domainsHow CloudSync's Sales Team Uses Branded Links in Cold Outreach Sequences
AutomationHow ThreadCraft Auto-Creates a Branded Link and QR Code for Every New Shopify SKU
AnalyticsHow City-Level Link Analytics Revealed CloudSync's Next Expansion Market