What would you like to know more about?

Create & Send Deep Links

Learn how to create deep links that open directly to a specific screen or record within your PocketPlatform app.

What is a deep link? A deep link is a special URL that opens your church's mobile app directly to a specific screen. Deep links make it easy to send people straight into the app experience from an email, text message, or your website. These links are perfect for promoting events, volunteer opportunities, or check-in options directly inside the app!

You can direct app users to a screen in your app using your "customer slug" and the path listed in your navigation file.
Note: In order for deep links to open correctly, your app must be installed on the user's device. Otherwise, the link will not resolve properly.
Open your navigation file:
  1. You have a "customer slug", which is a short, unique identifier used in API URLs.
    The format looks like this: https://{customer-slug}.api.pocketplatform.io/v2/navigation
  2. To open your navigation file, copy the link and replace {customer-slug} with your church's slug. Then paste that link into your browser, and press Enter.
    Your navigation file displays. It contains every screen and path available within your app.
Find the screen and record you want to link to:
  1. Search the navigation file for the name of the screen. The <path> element tells you the route that PocketPlatform uses inside the app.
    If you want to link to the event registration screen, search for "register". Your path would be register.

    Example of the navigation file showing the EventRegistrationScreen component path

    If you want to link to self check-in, search for "checkin". Your path would be self_checkin.

    Example of the navigation file showing the SelfCheckInScreen component path

  2. In MinistryPlatform, open the record for your target item (such as the Event record or Opportunity record). Note the ID number of this record.
Build your deep link:
  1. Using the information you gathered, build your deep link in this format: {customer-slug}://{path}/{id}
    Gathered InformationResulting Deep Link
    • Customer slug is mychurch
    • Want to link to registration screen
    • Event record ID is 123
    mychurch://register/123
    • Customer slug is mychurch
    • Want to link to serving opportunity screen
    • Opportunity record ID is 99
    mychurch://opportunity/99
    • Customer slug is mychurch
    • Want to link to a list
    • List record ID is 42
    mychurch://lists/42
    • Customer slug is mychurch
    • Want to link to self check-in
    • Event record ID is 1001
    mychurch://self_checkin/1001
  2. Copy the deep link you built using your information.
Test your link:
  1. Paste the link into an email, text message, or note on your mobile device where the app is installed.
  2. Tap the link.
    The link should open in the PocketPlatform app on your device.
  3. Double-check that the screen, record ID, and permissions all match what you expect.

Your link is ready to send to app users! Copy the link again and paste it into the email, text message, or other communication you want to send.