description |
---|
Using the connected email scope |
This guide will walk you through how to request email addresses from your user using the Email Scope.
In your application OAuth configuration make sure that the "email" scope is selected in the "allowed scopes" dropdown. Make sure to save this configuration before moving to step 2.
Email Scope Dropdown
When logging in users make sure you add email
to the scope
query param. Your auth url should look something like this https://<rollup.id or your custom domain>/authorize?client_id=xxx&state=xxx&scope=email
After authenticating into your custom Rollup application, your users will we be presented with an authorization screen containing the email scope authorization request.
If the user already as a connected email, this email will be automatically selected. If no email address is connected to their identity they can connect an new email address and continue.
Email Authorization
When redirected back to your application, the access token will now contain an authorization for email address. The email address will also be available returned in the user token via the user info endpoint.