Deep Links¶
A deep link is an ordinary web link to your church’s TouchPoint URL that opens directly inside the mobile app when the app is installed on the device. The person who taps the link is already authenticated, so they land on the requested screen without signing in again.
Any link to your database URL works as a deep link, and a number of well-known links receive special handling so that the app opens the exact screen the link points to instead of the home feed.
Note
Deep links require version 3.10 or later of the mobile app.
How Deep Links Work¶
Both of your church’s URLs work
A deep link can use either the standard TouchPoint URL or your custom URL. Both forms behave identically.
Standard:
https://yourchurch.tpsdb.com/eventsCustom:
https://my.yourchurch.org/events
When the link matches a known screen
The app opens that screen directly. The screens that receive this special handling are listed in Main Screens and Detail Screens below.
When the link is any other page on your church URL
The app still opens the link, but displays it inside the app in an authenticated web view. The user does not have to log in again, and they stay inside the app rather than being handed off to a browser.
When the user is not signed in yet
The app holds on to the link, prompts the user to sign in, and then takes them to the requested screen once they are authenticated.
When the app is not installed
Nothing breaks. The link opens in the device’s browser and behaves like any other TouchPoint link.
Important
A deep link does not grant any additional access. The user only sees content their own TouchPoint record and roles already allow them to see.
Where You Can Use Deep Links¶
Because a deep link is just a URL, you can place it anywhere you would place a normal link:
Email - link Register Now in a promotional email directly to the event in the app
SMS/Text - text a link to a prayer request or a giving page
Push Notifications - put the link in the Deep Link field so tapping the notification opens that screen. See Push Notifications
QR Codes - print a QR code in a bulletin or on a sign that opens the event detail screen
NFC Tags - program an NFC tag at a welcome desk or kiosk that opens the directory or a profile when tapped
A deep link entered on the Send Message/Notification page¶
Use Case
To drive registrations for a retreat, generate a QR code for the event detail deep link and print it in the worship bulletin. Members who already have the app scan the code and arrive on the retreat’s event screen, signed in and ready to register, with no searching and no second login.
Main Screens¶
These deep links open a primary area of the app. Replace yourchurch.tpsdb.com with
your standard or custom URL.
Screen |
Path |
Example |
|---|---|---|
Home |
|
|
Prayer |
|
|
Events |
|
|
Giving |
|
|
Giving History |
|
|
Media |
|
|
Directory |
|
|
Notifications |
|
|
Sermon Notes |
|
|
Take Attendance |
|
|
Pre Check-In |
|
|
My Tasks |
|
|
Note
Home, Prayer, Events, Giving, and Media open correctly whether or not you have included them in the app’s tab bar. See Mobile App Setup for the settings that control each of these features.
Detail Screens¶
These deep links open a specific record. Substitute the ID of the item you want to open for the placeholder shown in the path.
Screen |
Path |
Example |
|---|---|---|
Prayer |
|
|
Post |
|
|
Comment |
|
|
Event |
|
|
Event Meeting |
|
|
Sermon |
|
|
Resource |
|
|
Profile |
|
|
Current Person’s Profile |
|
|
Channel |
|
|
Message |
|
|
Task |
|
|
Tip
/event/{id} and /org/{id} are accepted as shorthand for
/event-detail/{id}, including the optional meeting ID. Use whichever form is
easiest to build into your email or QR code.
Tip
Use /profile/0 when you want a link that always opens the profile of whoever taps
it. This is useful in a mass email or on a printed QR code, since one link works for
everyone.
Note
A person who does not have access to a record, or a record that has been deleted, will not open the detail screen.
Finding the ID for a Deep Link¶
The IDs used in a detail deep link are the same IDs TouchPoint uses elsewhere:
Event - the Involvement ID, shown in the URL when you view the Involvement in TouchPoint
Event Meeting - the Meeting ID, shown in the URL when you view the meeting
Profile - the People ID
Prayer, Post, Comment, Sermon, Resource, Channel, Message, Task - the record’s ID within that feature
Linking to the App Store¶
To send people who do not yet have the app to the correct app store for their device, add
/app to the end of your church URL.
Standard:
https://yourchurch.tpsdb.com/appCustom:
https://my.yourchurch.org/app
Latest Update |
09/14/2026 |
New article documenting mobile app deep links, the main and detail screen paths they support, how unrecognized links are handled in the app, and where deep links can be used. Added push notifications as a place to use a deep link, with a screenshot of the Deep Link field.