Single Sign On

The SSO process consists of two simple steps:

1. Creating a one-time token

curl --location --request GET 'https://api.vcita.com/v1/partners/sso/token?business_uid={BUSINESS_ID}' \
--header 'Authorization: Token token="{DIRECTORY_TOKEN}"'

{
  "sso_token": "aaabbbcccddd111222333444",
  "expires_at": 123456789
}

Note: the returned token will remain valid for 30 minutes.

→ Use the business_uid to log in users with admin access.
→ Alternately, use the staff_uid to log in users as specific staff members (Please refer to the staff API reference).

2. Build the SSO login URL

Simply copy-paste the below URL and replace {SSO_TOKEN} with the token you received on step 1.

https://api.vcita.com/v1/partners/sso/login?business_uid=xxxzzz111&sso_token={SSO_TOKEN}