Getting Started

How to get setup

New Provider

VTS requires the following:

  1. Redirect URL (ex. www.service-provider.com/vts)
  2. Callback URL (this is the url that will receive the token - it can be the same as the redirect URL) ex: www.service-provider.com
  3. The claims required and any customer static claims required
  4. Customer app URL/whitelabel name & locations it needs to be enabled for
  5. Mutual NDA to be signed

Please send the request to get setup a request to [email protected] - using the template below - with your VTS account rep and customer main contact CC'ed.

Subject: New OIDC partner setup request

Hi,

I would like to setup OIDC for a new service provider.

Email address for NDA to be sent: ex. [email protected] {alternatively you can email your NDA to [email protected] - please include customer info and context}

Customer information:

  1. Customer Name: ex. 480 Main
  2. Location URL: ex. https://activate.vts.com/l/tab/480-main-st/home {please ensure location name is in URL}
  3. Whitelabel name: ex. 480 Main in apple app store

OIDC Configuration information:

  1. Testing:
    1. Redirect URL (ex. www.service-provider.com/dev)
    2. Callback URL (this is the url that will receive the token - it can be the same as the redirect URL) ex: www.service-provider.com/dev
  2. Production (if different):
    1. Redirect URL (ex. www.service-provider.com/vts)
    2. Callback URL (this is the url that will receive the token - it can be the same as the redirect URL) ex: www.service-provider.com
  3. Claims required {see list in supported claims}
    1. nickname
    2. building_id
    3. tenant_id
  4. Static claims required
    1. ex. client_id: 555_brodway

Thank You


VTS will provide:

Response time can vary but usually within 5 business days

  1. VTS will respond with NDA being sent to the email provided.
  2. Once that is setup VTS will provide:
    1. A sandbox app for testing
    2. Client ID, Example: izgmCHvK9Wqu3SipGdf8ldfjglsjflgjdlgjueyi
    3. Auth0 Domain, Example: auth.vts.com
    4. ext-integration-id in Redirect URL which is specifically for custom claims (this is passed as query parameters in the redirect URL)

Existing Provider

VTS requires the following:

  1. Customer app URL/whitelabel name & locations it needs to be enabled for
  2. {if different} Redirect URL (ex. www.service-provider.com/vts)
  3. {if different} Callback URL (this is the url that will receive the token - it can be the same as the redirect URL) ex: www.service-provider.com
  4. {if different} The claims required and any customer static claims required

Please send the request to get setup a request to [email protected] - using the template below - with your VTS account rep and customer main contact CC'ed.

Subject: Enable OIDC partner on new customer account

Hi,

I would like to enable our OIDC integraiton for a new customer.

Customer information:

  1. Cusotmer Name: ex. 480 Main
  2. Location URL: ex. https://activate.vts.com/l/tab/480-main-st/home {please ensure location name is in URL}
  3. Whitelabel name: ex. 480 Main in apple app store

OIDC Configuration information:

  1. Testing:
    1. Redirect URL (ex. www.service-provider.com/vts)
    2. Callback URL (this is the url that will receive the token - it can be the same as the redirect URL) ex: www.service-provider.com
  2. Production (if differnet):
    1. Redirect URL (ex. www.service-provider.com/vts)
    2. Callback URL (this is the url that will receive the token - it can be the same as the redirect URL) ex: www.service-provider.com
  3. Claims required
    1. nickname
    2. building_id
    3. tenant_id
  4. Static claims required
    1. client_id: 555_brodway

Thank You


VTS will provide:

Response time can vary but usually within 5 business days

VTS will provide:

  1. {if needed} A sandbox app for testing
  2. {if needed} Client ID, Example: izgmCHvK9Wqu3SipGdf8ldfjglsjflgjdlgjueyi
  3. {if needed} Auth0 Domain, Example: auth.vts.com
  4. {only if custom claims are used} ext-integration-id in Redirect URL which is specifically for custom claims (this is passed as query parameters in the redirect URL)

Interested in using our Next-Generation API Suite? Request Access by emailing [email protected]