Self-Service Scheduling (PSS) URL Parameters Guide
Keona Health’s Self-Service Scheduling (PSS) tool supports customizable URL parameters that allow you to control what users see when they access scheduling links. This guide explains how to construct these links and what each parameter does.
Base URL
Start with your base PSS URL:
https://yourpractice-pss.keonahealth.com/selfservicescheduling
To customize behavior, add parameters to this base URL.
How to Add URL Parameters
Follow these simple rules:
- The first parameter must be preceded by a ?
- Each additional parameter must be preceded by &
- You can combine multiple parameters, but only use one of each
- The full URL must be under 2048 characters
Common URL Parameters
Parameter | Description |
locationPmId=[ID] | Preselects a location (practice) by its PM ID. Skips the location selection screen. |
providerPmId=[ID] | Preselects a specific provider/resource by PM ID. Use any to include all providers. Skips the provider selection screen. |
menuItemId=[ID] | Directs the user to a specific scheduling menu item. You can find this ID in the Keona Admin dashboard. |
locationPreview=true | Enables the "Next Availability" preview feature on the location selection page. |
variant=B | Activates a different workflow where users select a location before choosing a provider. This is useful when transitioning users to a location-first experience. |
liineId=[ID] | Can be included, but does not affect PSS behavior. Optional. |
Examples
✅ Preselect all providers:
https://yourpractice-pss.keonahealth.com/selfservicescheduling?providerPmId=any
✅ Enable location-first workflow + show next availability:
https://yourpractice-pss.keonahealth.com/selfservicescheduling?variant=B&locationPreview=true
(You can reverse the order of parameters; it works the same)
✅ Preselect a specific provider and enable next availability:
https://yourpractice-pss.keonahealth.com/selfservicescheduling?locationPreview=true&providerPmId=1234
✅ Direct to Urgent Care at a specific location with menu and provider preselected:
https://yourpractice-pss.keonahealth.com/selfservicescheduling?menuItemId=0a135f91-f110-4186-90bd-af1d00d1ad6d&providerPmId=1449&locationPmId=916
Customers can manually create links to PSS with preselected choices to post on their websites. They can use the following query string parameters and data in Keona to create them:
PSS Menu Items
Query string parameter - MenuItemId
Location
Query string parameter - locationPmId
Provider
Query string parameter - providerPmId
Example for the Above Selections
https://yourpractice-pss.keonahealth.com/selfservicescheduling?MenuItemId=3dec532b-a2f3-422c-b543-adf70152633e&providerPmId=482&locationPmId=582
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article