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.
providerstringRequired

Your OAuth Provider ID.

accessTokenstringOptional

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

codestringOptional

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

Response

This endpoint returns an object.
_idstringOptional
emailstringOptional
namestringOptional
slugstringOptional
rolestringOptional

Usually either ‘teacher’ or ‘student’

statsobjectOptional
oAuthIdentitieslist of objectsOptional
subscriptionobjectOptional
licenseobjectOptional