diff --git a/bitbucket-pipelines.yml b/bitbucket-pipelines.yml
index 033e4a3ac..433387269 100644
--- a/bitbucket-pipelines.yml
+++ b/bitbucket-pipelines.yml
@@ -8,7 +8,7 @@ pipelines:
           script:
             - cd jam-ui
             - npm install 
-            - CI=false REACT_APP_ORIGIN=staging.jamkazam.com REACT_APP_LEGACY_BASE_URL=https://staging.jamkazam.com REACT_APP_API_BASE_URL=https://staging.jamkazam.com/api REACT_APP_BITBUCKET_BUILD_NUMBER=$BITBUCKET_BUILD_NUMBER REACT_APP_BITBUCKET_COMMIT=$BITBUCKET_COMMIT npm run build
+            - CI=false REACT_APP_ORIGIN=staging.jamkazam.com REACT_APP_CLIENT_BASE_URL=https://staging.jamkazam.com REACT_APP_API_BASE_URL=https://staging.jamkazam.com/api REACT_APP_BITBUCKET_BUILD_NUMBER=$BITBUCKET_BUILD_NUMBER REACT_APP_BITBUCKET_COMMIT=$BITBUCKET_COMMIT npm run build
           artifacts:
             - jam-ui/build/**
       - step:
@@ -24,7 +24,7 @@ pipelines:
           script:
             - cd jam-ui
             - npm install 
-            - CI=false REACT_APP_ORIGIN=jamkazam.com REACT_APP_LEGACY_BASE_URL=https://www.jamkazam.com REACT_APP_API_BASE_URL=https://www.jamkazam.com/api REACT_APP_BITBUCKET_BUILD_NUMBER=$BITBUCKET_BUILD_NUMBER REACT_APP_BITBUCKET_COMMIT=$BITBUCKET_COMMIT npm run build
+            - CI=false REACT_APP_ORIGIN=jamkazam.com REACT_APP_CLIENT_BASE_URL=https://www.jamkazam.com REACT_APP_API_BASE_URL=https://www.jamkazam.com/api REACT_APP_BITBUCKET_BUILD_NUMBER=$BITBUCKET_BUILD_NUMBER REACT_APP_BITBUCKET_COMMIT=$BITBUCKET_COMMIT npm run build
           artifacts:
             - jam-ui/build/**
 
diff --git a/jam-ui/.env.development b/jam-ui/.env.development
index e92816d59..cc2e6087d 100644
--- a/jam-ui/.env.development
+++ b/jam-ui/.env.development
@@ -1,7 +1,7 @@
 HOST=beta.jamkazam.local
 PORT=4000
 REACT_APP_ORIGIN=jamkazam.local
-REACT_APP_LEGACY_BASE_URL=http://www.jamkazam.local:3000
+REACT_APP_CLIENT_BASE_URL=http://www.jamkazam.local:3000
 REACT_APP_API_BASE_URL=http://www.jamkazam.local:3000/api
 REACT_APP_BITBUCKET_BUILD_NUMBER=dev
 REACT_APP_BITBUCKET_COMMIT=dev
\ No newline at end of file
diff --git a/jam-ui/.env.development.example b/jam-ui/.env.development.example
index e92816d59..cc2e6087d 100644
--- a/jam-ui/.env.development.example
+++ b/jam-ui/.env.development.example
@@ -1,7 +1,7 @@
 HOST=beta.jamkazam.local
 PORT=4000
 REACT_APP_ORIGIN=jamkazam.local
-REACT_APP_LEGACY_BASE_URL=http://www.jamkazam.local:3000
+REACT_APP_CLIENT_BASE_URL=http://www.jamkazam.local:3000
 REACT_APP_API_BASE_URL=http://www.jamkazam.local:3000/api
 REACT_APP_BITBUCKET_BUILD_NUMBER=dev
 REACT_APP_BITBUCKET_COMMIT=dev
\ No newline at end of file
diff --git a/jam-ui/.env.production b/jam-ui/.env.production
index 14fe4f7a1..4b10dd841 100644
--- a/jam-ui/.env.production
+++ b/jam-ui/.env.production
@@ -1,5 +1,5 @@
 HOST=beta.jamkazam.com
 PORT=4000
 REACT_APP_ORIGIN=jamkazam.com
-REACT_APP_LEGACY_BASE_URL=https://www.jamkazam.com
+REACT_APP_CLIENT_BASE_URL=https://www.jamkazam.com
 REACT_APP_API_BASE_URL=https://www.jamkazam.com/api
\ No newline at end of file
diff --git a/jam-ui/.env.staging b/jam-ui/.env.staging
index 5f09f9e85..6d976fa8b 100644
--- a/jam-ui/.env.staging
+++ b/jam-ui/.env.staging
@@ -1,5 +1,5 @@
 HOST=beta.staging.jamkazam.com
 PORT=4000
 REACT_APP_ORIGIN=staging.jamkazam.com
-REACT_APP_LEGACY_BASE_URL=https://staging.jamkazam.com
+REACT_APP_CLIENT_BASE_URL=https://staging.jamkazam.com
 REACT_APP_API_BASE_URL=https://staging.jamkazam.com/api
\ No newline at end of file
diff --git a/jam-ui/README.md b/jam-ui/README.md
index 9ab81eefa..e5fe6f2a6 100644
--- a/jam-ui/README.md
+++ b/jam-ui/README.md
@@ -8,7 +8,7 @@ The DOMAIN and PORT running this app is defined in env.production file. This fil
 
 HOST=beta.jamkazam.local
 PORT=4000
-REACT_APP_LEGACY_BASE_URL=http://www.jamkazam.local:3000
+REACT_APP_CLIENT_BASE_URL=http://www.jamkazam.local:3000
 REACT_APP_API_BASE_URL=http://www.jamkazam.local:3000/api
 
 ## Subdomains setup (development)
diff --git a/jam-ui/src/components/auth/JKLoginRequest.js b/jam-ui/src/components/auth/JKLoginRequest.js
index 7521442be..72f9eff52 100644
--- a/jam-ui/src/components/auth/JKLoginRequest.js
+++ b/jam-ui/src/components/auth/JKLoginRequest.js
@@ -16,7 +16,7 @@ function JKLoginRequest() {
                 <p>Please sign in to your jamkazam account</p>
               </Row>
               <Row className="justify-content-center">
-                <a className="btn btn-primary" href={`${process.env.REACT_APP_LEGACY_BASE_URL}/signin`}>
+                <a className="btn btn-primary" href={`${process.env.REACT_APP_CLIENT_BASE_URL}/signin`}>
                   Sign in
                 </a>
               </Row>
diff --git a/jam-ui/src/components/auth/LogoutContent.js b/jam-ui/src/components/auth/LogoutContent.js
index b277c4cd7..ebf0eb235 100644
--- a/jam-ui/src/components/auth/LogoutContent.js
+++ b/jam-ui/src/components/auth/LogoutContent.js
@@ -7,7 +7,7 @@ import rocket from '../../assets/img/illustrations/rocket.png';
 
 const LogoutContent = ({ layout, titleTag: TitleTag }) => {
   const goToLogin = () => {
-    window.location.href = `${process.env.REACT_APP_LEGACY_BASE_URL}/signin`
+    window.location.href = `${process.env.REACT_APP_CLIENT_BASE_URL}/signin`
   }
   return (
     <Fragment>
@@ -16,7 +16,7 @@ const LogoutContent = ({ layout, titleTag: TitleTag }) => {
       <p>
         Thanks for using JamKazam. You are <br className="d-none d-sm-block" />
         now successfully signed out.
-        {process.env.REACT_APP_LEGACY_BASE_URL}
+        {process.env.REACT_APP_CLIENT_BASE_URL}
       </p>
       {/* <Button tag={Link} color="primary" size="sm" className="mt-3" to={`/authentication/${layout}/login`}>
         <FontAwesomeIcon icon="chevron-left" transform="shrink-4 down-1" className="mr-1" />
diff --git a/jam-ui/src/components/auth/basic/Login.js b/jam-ui/src/components/auth/basic/Login.js
index 7794b41d5..66a20a878 100644
--- a/jam-ui/src/components/auth/basic/Login.js
+++ b/jam-ui/src/components/auth/basic/Login.js
@@ -18,7 +18,7 @@ const Login = () => (
         <p className="fs--1 text-600">
           or {' '}
           {/* <Link to="/authentication/basic/register">create an account</Link> */}
-          <a href={`${process.env.REACT_APP_LEGACY_BASE_URL}/signup`}>Sign up</a>
+          <a href={`${process.env.REACT_APP_CLIENT_BASE_URL}/signup`}>Sign up</a>
         </p>
       </Col>
     </Row>
diff --git a/jam-ui/src/components/auth/basic/Start.js b/jam-ui/src/components/auth/basic/Start.js
index 22418a2b2..cd099de62 100644
--- a/jam-ui/src/components/auth/basic/Start.js
+++ b/jam-ui/src/components/auth/basic/Start.js
@@ -5,7 +5,7 @@ import { FontAwesomeIcon } from "@fortawesome/react-fontawesome";
 
 const Start = () => {
   const goToLogin = () => {
-    window.open(`${process.env.REACT_APP_LEGACY_BASE_URL}/signin`, '_blank')
+    window.open(`${process.env.REACT_APP_CLIENT_BASE_URL}/signin`, '_blank')
   }
   return(
     <Fragment>
diff --git a/jam-ui/src/components/dashboard/JKDashboardMain.js b/jam-ui/src/components/dashboard/JKDashboardMain.js
index b0311d272..eb3a55a72 100644
--- a/jam-ui/src/components/dashboard/JKDashboardMain.js
+++ b/jam-ui/src/components/dashboard/JKDashboardMain.js
@@ -165,7 +165,7 @@ function JKDashboardMain() {
     }
   };
 
-  useScript(`${process.env.REACT_APP_LEGACY_BASE_URL}/client_scripts`, initJKScripts);
+  useScript(`${process.env.REACT_APP_CLIENT_BASE_URL}/client_scripts`, initJKScripts);
 
   return (
     <div className={isFluid || isKanban ? 'container-fluid' : 'container'}>
diff --git a/jam-ui/src/components/footer/JKFooter.js b/jam-ui/src/components/footer/JKFooter.js
index a184c2d25..48b9f9e82 100644
--- a/jam-ui/src/components/footer/JKFooter.js
+++ b/jam-ui/src/components/footer/JKFooter.js
@@ -18,23 +18,23 @@ const JKFooter = () => {
         <Col sm="auto">
           <p className="mb-0 text-600 text-lowercase">
             {' '}
-            <a href={`${process.env.REACT_APP_LEGACY_BASE_URL}/corp/about`} target="_blank">
+            <a href={`${process.env.REACT_APP_CLIENT_BASE_URL}/corp/about`} target="_blank">
               {t('navigation.about', {ns: 'common'})}
             </a>{' '}
             |{' '}
-            <a href={`${process.env.REACT_APP_LEGACY_BASE_URL}/corp/contact`} target="_blank">
+            <a href={`${process.env.REACT_APP_CLIENT_BASE_URL}/corp/contact`} target="_blank">
             {t('navigation.contact', {ns: 'common'})}
             </a>{' '}
             |{' '}
-            <a href={`${process.env.REACT_APP_LEGACY_BASE_URL}/corp/privacy`} target="_blank">
+            <a href={`${process.env.REACT_APP_CLIENT_BASE_URL}/corp/privacy`} target="_blank">
             {t('navigation.privacy', {ns: 'common'})}
             </a>{' '}
             |{' '}
-            <a href={`${process.env.REACT_APP_LEGACY_BASE_URL}/corp/terms`} target="_blank">
+            <a href={`${process.env.REACT_APP_CLIENT_BASE_URL}/corp/terms`} target="_blank">
             {t('navigation.terms', {ns: 'common'})}
             </a>
             |{' '}
-            <a href={`${process.env.REACT_APP_LEGACY_BASE_URL}/help_desk`} target="_blank">
+            <a href={`${process.env.REACT_APP_CLIENT_BASE_URL}/help_desk`} target="_blank">
             {t('navigation.help', {ns: 'common'})}
             </a>
           </p>
diff --git a/jam-ui/src/components/navbar/JKTopNavRightSideNavItem.js b/jam-ui/src/components/navbar/JKTopNavRightSideNavItem.js
index a50baf093..648fd6752 100644
--- a/jam-ui/src/components/navbar/JKTopNavRightSideNavItem.js
+++ b/jam-ui/src/components/navbar/JKTopNavRightSideNavItem.js
@@ -30,7 +30,7 @@ const TopNavRightSideNavItem = () => {
 
       <NavbarText className="d-none d-md-inline">{t('keep_jamkazam_improving', { ns: 'common' })}:</NavbarText>
       <NavItem className="d-none d-md-inline ml-1 mr-6">
-        <a className="nav-link" href={`${process.env.REACT_APP_LEGACY_BASE_URL}/client#/account/subscription`} target="_blank">
+        <a className="nav-link" href={`${process.env.REACT_APP_CLIENT_BASE_URL}/client#/account/subscription`} target="_blank">
           {t('subscribe', { ns: 'common' })}
         </a>
       </NavItem>
diff --git a/jam-ui/src/components/page/JKHelp.js b/jam-ui/src/components/page/JKHelp.js
index 9b4681339..4d1381309 100644
--- a/jam-ui/src/components/page/JKHelp.js
+++ b/jam-ui/src/components/page/JKHelp.js
@@ -2,7 +2,7 @@ import React, {useEffect} from 'react'
 
 const JKHelp = () => {
   useEffect(() => {
-    window.location.href = `${process.env.REACT_APP_LEGACY_BASE_URL}/help_desk`
+    window.location.href = `${process.env.REACT_APP_CLIENT_BASE_URL}/help_desk`
     return () => {
     };
   }, [])
diff --git a/jam-ui/src/components/page/JKNewMusicSession.js b/jam-ui/src/components/page/JKNewMusicSession.js
index a5d341831..12655cb06 100644
--- a/jam-ui/src/components/page/JKNewMusicSession.js
+++ b/jam-ui/src/components/page/JKNewMusicSession.js
@@ -63,10 +63,13 @@ const JKNewMusicSession = () => {
     const payload = {
       privacy: formData.get('privacy'),
       description: formData.get('description'),
-      inviteeIds: invitees.map(i => i.id)
+      inviteeIds: invitees.map(i => i.id).join()
     };
-    console.log(payload); //TODO: handle payload
-    
+    console.log(payload);
+    //window.open jamkazam app url using custom URL scheme
+    //an example URL would be: jamkazam://url=https://www.jamkazam.com/client#/createSession/privacy~2|description~hello|inviteeIds~1,2,3,4 
+    const q = `privacy~${payload.privacy}|description~${payload.description}|inviteeIds~${payload.inviteeIds}`
+    window.open(`jamkazam://url=${process.env.REACT_APP_CLIENT_BASE_URL}/client#/createSession/${q}`)
     try {
       //store this payload in localstorage.
       localStorage.setItem('formData', JSON.stringify(payload))  
diff --git a/web/app/assets/javascripts/scheduled_session.js.erb b/web/app/assets/javascripts/scheduled_session.js.erb
index fefb85cdb..26c1d6fd0 100644
--- a/web/app/assets/javascripts/scheduled_session.js.erb
+++ b/web/app/assets/javascripts/scheduled_session.js.erb
@@ -1517,6 +1517,24 @@
       $startOrScheduledBtn.on('click', clickStartOrSchedule)
     }
 
+    //handle jamkazam:// custom URL scheme params
+    function decodeCustomSchemaParams(){
+      const hash = context.location.hash;
+      const qStr = hash.substring(hash.lastIndexOf('/') + 1);
+      //an example URL would be: https://www.jamkazam.com/client#/createSession/privacy~2|description~hello|inviteeIds~1,2,3,4 
+      const qParamsArr = qStr.split('|'); 
+      let privacy, description, inviteeIds;
+      qParamsArr.each(function(q){
+        const qp = q.split('~')
+        if(qp[0] === 'privacy') privacy = qp[1] 
+        if(qp[0] === 'description') description = qp[1] 
+        if(qp[0] === 'inviteeIds') inviteeIds = qp[1] 
+      })
+      
+
+
+    }
+
     function initialize(invitationDialogInstance, friendSelectorDialog, instrumentSelectorInstance, instrumentRSVPSelectorInstance) {
 
       inviteMusiciansUtil = new JK.InviteMusiciansUtil(app);