If you want a conceptual overview before the implementation steps, read how deferred deep linking works<\/a> first.<\/p>\n\n\n\n In Tolinku, each app gets its own Appspace. An Appspace holds your routes, links, banners, analytics, and team settings.<\/p>\n\n\n\n You'll land on the Appspace dashboard. Keep this tab open; you'll need the Appspace ID in a moment.<\/p>\n\n\n\n Your deferred links need a domain that's associated with your app for Universal Links (iOS) and App Links (Android) to work.<\/p>\n\n\n\n In your Xcode project:<\/p>\n\n\n\n Tolinku automatically serves the Apple App Site Association (AASA)<\/a> file at If you're using a custom domain, verify in the Tolinku dashboard that your domain's DNS is pointing to Tolinku's servers and that the SSL certificate has been issued before proceeding.<\/p>\n\n\n\n In your Tolinku automatically serves the Digital Asset Links<\/a> file at To get your SHA-256 fingerprint for debug builds:<\/p>\n\n\n\n Add both your debug and release fingerprints to the dashboard.<\/p>\n\n\n\n In Xcode, go to File > Add Package Dependencies. Enter:<\/p>\n\n\n\n Select the latest version and add Add the Tolinku SDK to your For iOS, run Run Full platform-specific setup is in the Tolinku SDK documentation<\/a>.<\/p>\n\n\n\n Initialize the SDK at app launch. Pass your Tolinku publishable key ( In your For apps using In your Register your In your root component ( The SDK fires a callback on first launch when a deferred link match is found. Register this handler before your app renders its initial route.<\/p>\n\n\n\n Important:<\/strong> Register the callback before the app renders the first screen. If you register it after navigation has already rendered, you may miss the callback on first launch.<\/p>\n\n\n\n Routes in Tolinku define what paths your links can target and how they map to in-app destinations.<\/p>\n\n\n\n Routes support path parameters ( Now create an actual link that uses your route.<\/p>\n\n\n\n Your link is now live. Copy the link URL for testing.<\/p>\n\n\n\n You can also create links programmatically using the Tolinku API:<\/p>\n\n\n\n The API returns the link URL and a short link URL. Both work for deferred linking.<\/p>\n\n\n\n Testing deferred deep links requires a physical device and a TestFlight (iOS) or Internal App Sharing (Android) build, since you need to simulate a real store install.<\/p>\n\n\n\n Quick test flow:<\/strong><\/p>\n\n\n\n For detailed testing steps, edge cases (ATT denied, in-app browsers, slow networks), and debugging tips, see how to test deferred deep links<\/a>.<\/p>\n\n\n\n The dashboard should show:<\/p>\n\n\n\n If the click event is missing, check that your link URL is correct and that the Tolinku SDK is initialized before the link is opened (this matters for same-device testing scenarios).<\/p>\n\n\n\n If the install is missing, verify your bundle identifier in the Appspace settings matches the bundle ID in your app.<\/p>\n\n\n\n Once testing is complete:<\/p>\n\n\n\n With deferred links working, you can build more sophisticated patterns:<\/p>\n\n\n\n For the full range of things you can build with deferred links, see 15 deferred deep linking use cases<\/a>.<\/p>\n\n\n\n Building deferred deep links with Tolinku involves five core steps: creating an Appspace, configuring your domain, installing the SDK, handling the deferred link callback, and creating links. Testing requires a real device and a store install flow, but once the integration is working, you can build all of your acquisition and activation linking on top of the same foundation.<\/p>\n\n\n\nStep 1: Create an Appspace<\/h2>\n\n\n\n
\n
com.yourcompany.yourapp<\/code>, Android: same or your app's application ID).<\/li>\nlinks.yourapp.com<\/code>). You can also use a Tolinku subdomain during development.<\/li>\n![\"Tolinku](\"https:\/\/tolinku.com\/blog\/wp-content\/uploads\/2026\/03\/platform-platform-settings.png\")
<\/p>\n\n\n\nStep 2: Configure Your Domain<\/h2>\n\n\n\n
iOS: Associated Domains<\/h3>\n\n\n\n
\n
applinks:links.yourapp.com<\/code><\/li>\n<\/ol>\n\n\n\nhttps:\/\/links.yourapp.com\/.well-known\/apple-app-site-association<\/code>. You don't need to host this file yourself.<\/p>\n\n\n\nAndroid: App Links<\/h3>\n\n\n\n
AndroidManifest.xml<\/code>, add an intent filter to the Activity that should handle deep links:<\/p>\n\n\n\n<activity android:name=".MainActivity">\n <intent-filter android:autoVerify="true">\n <action android:name="android.intent.action.VIEW" \/>\n <category android:name="android.intent.category.DEFAULT" \/>\n <category android:name="android.intent.category.BROWSABLE" \/>\n <data\n android:scheme="https"\n android:host="links.yourapp.com" \/>\n <\/intent-filter>\n<\/activity>\n<\/code><\/pre>\n\n\n\nhttps:\/\/links.yourapp.com\/.well-known\/assetlinks.json<\/code>. Set your SHA-256 certificate fingerprint in the Tolinku dashboard under "Android Configuration."<\/p>\n\n\n\nkeytool -list -v -keystore ~\/.android\/debug.keystore -alias androiddebugkey -storepass android -keypass android\n<\/code><\/pre>\n\n\n\nStep 3: Install the Tolinku SDK<\/h2>\n\n\n\n
iOS (Swift Package Manager)<\/h3>\n\n\n\n
https:\/\/github.com\/tolinku\/ios-sdk\n<\/code><\/pre>\n\n\n\nTolinkuSDK<\/code> to your app target.<\/p>\n\n\n\nAndroid (Gradle)<\/h3>\n\n\n\n
build.gradle<\/code> (app module):<\/p>\n\n\n\ndependencies {\n implementation("com.tolinku:sdk:latest.release")\n}\n<\/code><\/pre>\n\n\n\nReact Native<\/h3>\n\n\n\n
npm install @tolinku\/react-native-sdk\n<\/code><\/pre>\n\n\n\npod install<\/code> after installing the package.<\/p>\n\n\n\nFlutter<\/h3>\n\n\n\n
dependencies:\n tolinku: ^1.0.0\n<\/code><\/pre>\n\n\n\nflutter pub get<\/code> after adding the dependency.<\/p>\n\n\n\nStep 4: Initialize the SDK<\/h2>\n\n\n\n
tolk_pub_...<\/code>), which you'll find in the Appspace settings under "API Keys."<\/p>\n\n\n\niOS<\/h3>\n\n\n\n
AppDelegate.swift<\/code> or App.swift<\/code>:<\/p>\n\n\n\nimport TolinkuSDK\n\n@main\nstruct YourApp: App {\n init() {\n Tolinku.shared.configure(publishableKey: "tolk_pub_YOUR_KEY_HERE")\n }\n\n var body: some Scene {\n WindowGroup {\n ContentView()\n }\n }\n}\n<\/code><\/pre>\n\n\n\nAppDelegate<\/code>:<\/p>\n\n\n\nfunc application(_ application: UIApplication,\n didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {\n Tolinku.shared.configure(publishableKey: "tolk_pub_YOUR_KEY_HERE")\n return true\n}\n<\/code><\/pre>\n\n\n\nAndroid<\/h3>\n\n\n\n
Application<\/code> class:<\/p>\n\n\n\nclass MyApplication : Application() {\n override fun onCreate() {\n super.onCreate()\n Tolinku.configure(this, publishableKey = "tolk_pub_YOUR_KEY_HERE")\n }\n}\n<\/code><\/pre>\n\n\n\nApplication<\/code> class in AndroidManifest.xml<\/code>:<\/p>\n\n\n\n<application\n android:name=".MyApplication"\n ...>\n<\/code><\/pre>\n\n\n\nReact Native<\/h3>\n\n\n\n
App.tsx<\/code> or index.js<\/code>):<\/p>\n\n\n\nimport { Tolinku } from '@tolinku\/react-native-sdk';\n\nTolinku.configure({ publishableKey: 'tolk_pub_YOUR_KEY_HERE' });\n<\/code><\/pre>\n\n\n\nStep 5: Handle the Deferred Link Callback<\/h2>\n\n\n\n
iOS<\/h3>\n\n\n\n
Tolinku.shared.onDeferredLink { params in\n DispatchQueue.main.async {\n guard let destination = params["destination"] else { return }\n \/\/ Use your app's navigation system to route to `destination`\n NavigationManager.shared.navigate(to: destination, params: params)\n }\n}\n<\/code><\/pre>\n\n\n\nAndroid<\/h3>\n\n\n\n
Tolinku.onDeferredLink { params ->\n val destination = params["destination"] ?: return@onDeferredLink\n runOnUiThread {\n NavigationManager.navigate(destination, params)\n }\n}\n<\/code><\/pre>\n\n\n\nReact Native<\/h3>\n\n\n\n
import { Tolinku } from '@tolinku\/react-native-sdk';\n\nuseEffect(() => {\n Tolinku.onDeferredLink((params) => {\n const destination = params.destination;\n if (destination) {\n navigation.navigate(destination, params);\n }\n });\n}, []);\n<\/code><\/pre>\n\n\n\n![\"Orange](\"https:\/\/tolinku.com\/blog\/wp-content\/uploads\/2026\/03\/building-deferred-deep-links-inline-1.jpg\")
Step 6: Configure a Route in the Dashboard<\/h2>\n\n\n\n
\n
\/product\/:id<\/code>. For a sale, \/sale\/:slug<\/code>.<\/li>\n:id<\/code>), which are captured and passed to the app as part of the deferred link parameters.<\/p>\n\n\n\n![\"Tolinku](\"https:\/\/tolinku.com\/blog\/wp-content\/uploads\/2026\/03\/platform-platform-routes.png\")
<\/p>\n\n\n\nStep 7: Create a Deferred Link<\/h2>\n\n\n\n
Via the Dashboard<\/h3>\n\n\n\n
\n
\/product\/abc123<\/code>).<\/li>\nVia the API<\/h3>\n\n\n\n
curl -X POST https:\/\/app.tolinku.com\/v1\/links \\\n -H "Authorization: Bearer tolk_sec_YOUR_SECRET_KEY" \\\n -H "Content-Type: application\/json" \\\n -d '{\n "appspaceId": "your-appspace-id",\n "destination": "\/product\/abc123",\n "parameters": {\n "campaign": "spring_2026",\n "referrer": "email_newsletter"\n },\n "fallback": {\n "ios": "https:\/\/apps.apple.com\/app\/your-app-id",\n "android": "https:\/\/play.google.com\/store\/apps\/details?id=com.yourapp"\n }\n }'\n<\/code><\/pre>\n\n\n\nStep 8: Test the Integration<\/h2>\n\n\n\n
\n
destination<\/code> parameter.<\/li>\n\n
Step 9: Go Live<\/h2>\n\n\n\n
\n
tolk_pub_<\/code> key is safe to include in your app. Your tolk_sec_<\/code> key stays server-side only.<\/li>\nWhat's Next<\/h2>\n\n\n\n
\n
Summary<\/h2>\n\n\n\n