Add Oauth2 Identity

POST

Adds an OAuth2 identity to the user, so that they can be logged in with that identity. You need to send the OAuth code or the access token to this endpoint. 1. If no access token is provided, it will use your OAuth2 token URL to exchange the given code for an access token. 2. Then it will use the access token (given by you, or received from step 1) to look up the user on your service using the lookup URL, and expects a JSON object in response with an id property. 3. It will then save that user id to the user in our db as a new OAuthIdentity. In this example, we call your lookup URL (let’s say, https://oauth.provider/user?t=<%= accessToken %>) with the access token (1234). The lookup URL returns { id: 'abcd' } in this case, which we save to the user in our db.

Path parameters

handlestringRequired

The document’s _id or slug.

Request

This endpoint expects an object.
provider
stringRequired
Your OAuth Provider ID.
accessToken
stringOptional

Will be passed through your lookup URL to get the user ID. Required if no code.

code
stringOptional

Will be passed to the OAuth token endpoint to get a token. Required if no accessToken.

Response

This endpoint returns an object
_id
stringOptional
email
stringOptional
name
stringOptional
slug
stringOptional
role
stringOptional
Usually either 'teacher' or 'student'
stats
objectOptional
oAuthIdentities
list of objectsOptional
subscription
objectOptional
license
objectOptional