WarpLink

Quickstart

Create a WarpLink account, register your app, and get your first deep link working in under 30 minutes. Step by step.

This guide walks you through creating your first WarpLink deep link and testing it on a device.

1. Create an Account

Sign up at warplink.app. You'll automatically get a free organization with 10,000 monthly clicks.

2. Register Your App

In the dashboard, go to Apps and click Register App. Fill in your platform details:

Go to Links and click Create Link, or use the API:

You'll get back a short link like https://aplnk.to/abc123.

4. Install the SDK

Use an SDK key here, not an API key. The SDKs authenticate with an SDK key, created in the dashboard under API Keys > SDK key. It is pre-scoped for link resolution and install attribution. An API key looks identical (wl_live_ plus 32 characters) but cannot record installs, so deep links keep resolving while every attribution call is rejected and no installs appear in your dashboard.

Add WarpLink via Swift Package Manager:

Configure in your AppDelegate. One onLink callback receives taps and deferred installs:

Then forward the tapped URL to the SDK (there is no swizzling):

Scene-based apps forward from their scene delegate instead, and setting your delegate class to the drop-in WarpLinkAppDelegate or WarpLinkSceneDelegate does it for you. See the iOS SDK guide.

Add to your build.gradle.kts:

Initialize in your Application class. Cold start and the deferred check are wired automatically:

Install the package:

Configure in your app entry. One onLink callback handles cold start, warm start, and deferred installs:

On iOS, forward the tapped URL from your AppDelegate so taps reach the SDK. Add the WarpLink call to the delegate method you already have and keep returning your existing linking result, so React Navigation and Expo Linking still receive the URL:

Android needs no host code. The React Native SDK guide covers the Objective-C form, custom URL schemes, and Expo prebuild.

Serving links from a custom domain? Add one option so the SDK knows the domain is yours from the very first launch: linkDomains: ["links.yourapp.com"] at configure(), or the plist / manifest equivalent on native. Full detail in Use it in your app.

  1. Open https://aplnk.to/abc123 on a device with your app installed
  2. The link should open your app directly via Universal Links (iOS) or App Links (Android)
  3. If the app isn't installed, the user is redirected to the app store

Next Steps

On this page