Question
- Is there a way to return the installers name and email address during OAuth?
Solution
OpenID Connect (OIDC) is an extension of the standard OAuth Authorization Code flow that allows 3rd party app developers to retrieve additional metadata associated to the authorizing user. A successful response will return the following:
{
"email": "jane@thinkific.com",
"family_name": "Doe",
"given_name": "Jane",
"name": "Jane Doe",
"picture": "https://assets.thinkific.com/profile.png",
"roles": ["site_admin"],
"site": {
"currency": "usd",
"domain": "school.thinkific.com",
"name": "Jane's School",
"subdomain": "jane",
"support_email": "jane@thinkific.com"
},
"sub": "01EY1SAQY490WCG2H7SZ1365HN",
"user_id_api_v1": "123456780",
"updated_at": 1601504367
}
Application
Metadata retrieved using OIDC can to be used to simplify the app installation flow and personalize the experience. For instance, you might:
- Automatically create an account in your software using the installer's name and email address
- Create a welcome landing page in your software using the installer name
- Cache the Thinkific subdomain for use in future requests
For more information on how to implement OIDC successful please refer to our Authorization documentation.