SynqDocs
Reference

Provider scopes

Every scope beyond Synq’s minimum that a brand may ask each sign-in provider for, from each provider’s reviewed list.

A brand may ask each sign-in provider for more than Synq's minimum: these are the scopes each provider's list allows, from the provider's own documentation. Anything else is refused with scope_not_allowed. A scope whose status is Coming is refused with scope_unavailable until Synq reads it at sign-in or keeps people's provider tokens. One that needs your own app is refused with scope_needs_own_app where sign-ins go through Synq's. Ask a provider for more says how to set them. GET /v1/provider-scopes serves the same list.

Google

Synq always asks for openid email profile.

ScopeWhat the person sharesNeeds your own appHow it reaches youStatusSource
https://www.googleapis.com/auth/user.birthday.readSee your date of birthYesSynq reads it at sign-in (coming)ComingDocs
https://www.googleapis.com/auth/profile.agerange.readSee your age rangeYesSynq reads it at sign-in (coming)ComingDocs
https://www.googleapis.com/auth/user.phonenumbers.readSee the phone numbers on your Google AccountYesSynq reads it at sign-in (coming)ComingDocs
https://www.googleapis.com/auth/user.addresses.readSee the street addresses on your Google AccountYesSynq reads it at sign-in (coming)ComingDocs
https://www.googleapis.com/auth/profile.language.readSee which language you preferYesSynq reads it at sign-in (coming)ComingDocs
https://www.googleapis.com/auth/user.organization.readSee the work and education history on your Google profileYesSynq reads it at sign-in (coming)ComingDocs
https://www.googleapis.com/auth/calendar.freebusySee when you’re free or busy in Google Calendar, but not your eventsYesNeeds the person’s provider token (coming)ComingDocs
https://www.googleapis.com/auth/calendar.events.readonlySee the events on your Google calendarsYesNeeds the person’s provider token (coming)ComingDocs
https://www.googleapis.com/auth/calendar.app.createdMake a calendar of your brand’s own in Google Calendar and manage its eventsYesNeeds the person’s provider token (coming)ComingDocs
https://www.googleapis.com/auth/calendar.events.ownedAdd, change and delete events on the Google calendars you ownYesNeeds the person’s provider token (coming)ComingDocs
https://www.googleapis.com/auth/calendar.eventsAdd, change and delete events on all your Google calendarsYesNeeds the person’s provider token (coming)ComingDocs
https://www.googleapis.com/auth/contacts.readonlySee your Google contactsYesNeeds the person’s provider token (coming)ComingDocs
https://www.googleapis.com/auth/drive.fileSee and change only the Google Drive files you open or create with your brandYesNeeds the person’s provider token (coming)ComingDocs
https://www.googleapis.com/auth/drive.appdataKeep your brand’s own settings in a hidden folder in your Google DriveYesNeeds the person’s provider token (coming)ComingDocs
https://www.googleapis.com/auth/tasks.readonlySee your Google TasksYesNeeds the person’s provider token (coming)ComingDocs
https://www.googleapis.com/auth/tasksAdd, change and delete your Google TasksYesNeeds the person’s provider token (coming)ComingDocs
https://www.googleapis.com/auth/youtube.readonlySee your YouTube account and channelYesNeeds the person’s provider token (coming)ComingDocs

GitHub

Synq always asks for read:user user:email.

ScopeWhat the person sharesNeeds your own appHow it reaches youStatusSource
read:orgSee which GitHub organizations and teams you belong toYesSynq reads it at sign-in (coming)ComingDocs
read:public_keySee the SSH keys on your GitHub accountYesSynq reads it at sign-in (coming)ComingDocs
read:gpg_keySee the GPG keys on your GitHub accountYesSynq reads it at sign-in (coming)ComingDocs
read:projectSee your GitHub Projects boards, and your organizations’ boardsYesNeeds the person’s provider token (coming)ComingDocs
read:packagesDownload packages you can get from GitHub PackagesYesNeeds the person’s provider token (coming)ComingDocs
gistCreate and edit your gists for youYesNeeds the person’s provider token (coming)ComingDocs
notificationsSee your GitHub notifications, mark them read, and watch repositoriesYesNeeds the person’s provider token (coming)ComingDocs

Microsoft

Synq always asks for openid email profile User.Read.

ScopeWhat the person sharesNeeds your own appHow it reaches youStatusSource
Calendars.ReadBasicSee the times, titles and places of your Outlook events, but not their detailsYesNeeds the person’s provider token (coming)ComingDocs
Calendars.ReadSee the events in your Outlook calendarYesNeeds the person’s provider token (coming)ComingDocs
Calendars.ReadWriteAdd, change and delete events in your Outlook calendarYesNeeds the person’s provider token (coming)ComingDocs
MailboxSettings.ReadSee your Outlook settings, like your time zone, language and working hoursYesNeeds the person’s provider token (coming)ComingDocs
Contacts.ReadSee your Outlook contactsYesNeeds the person’s provider token (coming)ComingDocs
Files.ReadSee the files in your OneDriveYesNeeds the person’s provider token (coming)ComingDocs
Files.ReadWrite.AppFolderKeep your brand’s own files in a folder of its own in your OneDriveYesNeeds the person’s provider token (coming)ComingDocs
Files.ReadWriteSee, add, change and delete the files in your OneDriveYesNeeds the person’s provider token (coming)ComingDocs
Tasks.ReadSee your Microsoft To Do tasksYesNeeds the person’s provider token (coming)ComingDocs
Tasks.ReadWriteAdd, change and delete your Microsoft To Do tasksYesNeeds the person’s provider token (coming)ComingDocs
OnlineMeetings.ReadWriteCreate Microsoft Teams meetings for youYesNeeds the person’s provider token (coming)ComingDocs
Presence.ReadSee whether you’re available, busy or away in Microsoft Teams, with your status noteYesNeeds the person’s provider token (coming)ComingDocs

Apple

Synq always asks for openid name email.

Apple has nothing more to ask for: Synq's minimum covers every scope it has.

Facebook

Synq always asks for email public_profile.

ScopeWhat the person sharesNeeds your own appHow it reaches youStatusSource
user_age_rangeSee your age range from FacebookYesSynq reads it at sign-in (coming)ComingDocs
user_birthdaySee your birthdayYesSynq reads it at sign-in (coming)ComingDocs
user_friendsSee which of your Facebook friends also use your brandYesSynq reads it at sign-in (coming)ComingDocs
user_linkSee the link to your Facebook profileYesSynq reads it at sign-in (coming)ComingDocs
user_locationSee the city on your Facebook profileYesSynq reads it at sign-in (coming)ComingDocs
user_hometownSee your hometown from your Facebook profileYesSynq reads it at sign-in (coming)ComingDocs
user_genderSee the gender on your Facebook profileYesSynq reads it at sign-in (coming)ComingDocs
user_likesSee the Facebook Pages you’ve likedYesNeeds the person’s provider token (coming)ComingDocs
user_photosSee the photos you’ve uploaded to FacebookYesNeeds the person’s provider token (coming)ComingDocs
user_videosSee the videos you’ve uploaded to FacebookYesNeeds the person’s provider token (coming)ComingDocs
user_messenger_contactLet your brand’s Facebook Page message you on MessengerYesNeeds the person’s provider token (coming)ComingDocs

X

Synq always asks for users.read tweet.read users.email.

ScopeWhat the person sharesNeeds your own appHow it reaches youStatusSource
tweet.writePost and repost on X for youYesNeeds the person’s provider token (coming)ComingDocs
media.writeUpload photos and videos to X for youYesNeeds the person’s provider token (coming)ComingDocs
follows.readSee who you follow and who follows you on XYesNeeds the person’s provider token (coming)ComingDocs
like.readSee the posts you’ve liked on XYesNeeds the person’s provider token (coming)ComingDocs
bookmark.readSee your bookmarked posts on XYesNeeds the person’s provider token (coming)ComingDocs
bookmark.writeBookmark posts for you and remove bookmarksYesNeeds the person’s provider token (coming)ComingDocs
list.readSee your X Lists, including private onesYesNeeds the person’s provider token (coming)ComingDocs
block.readSee the accounts you’ve blocked on XYesNeeds the person’s provider token (coming)ComingDocs
mute.readSee the accounts you’ve muted on XYesNeeds the person’s provider token (coming)ComingDocs
space.readSee the Spaces you can view on XYesNeeds the person’s provider token (coming)ComingDocs
tweet.moderate.writeHide and unhide replies to your postsYesNeeds the person’s provider token (coming)ComingDocs

Discord

Synq always asks for identify email.

ScopeWhat the person sharesNeeds your own appHow it reaches youStatusSource
guildsSee which Discord servers you’re inNoSynq reads it at sign-in (coming)ComingDocs
guilds.members.readSee your nickname, roles and join date in Discord servers you’re inNoSynq reads it at sign-in (coming)ComingDocs
connectionsSee the other accounts you’ve linked to Discord, like Steam or YouTubeNoSynq reads it at sign-in (coming)ComingDocs
guilds.joinAdd you to your brand’s Discord serverYesNeeds the person’s provider token (coming)ComingDocs
role_connections.writeShow your your brand account details in Discord so servers can give you rolesYesNeeds the person’s provider token (coming)ComingDocs

Telegram

Synq always asks for openid profile.

ScopeWhat the person sharesNeeds your own appHow it reaches youStatusSource
phoneSee the phone number on your Telegram accountNoIn the ID token, kept on the identityAvailableDocs
telegram:bot_accessLet your brand’s Telegram bot send you messagesYesA permission at the provider, used with your own credentialsAvailableDocs

Matrica

Synq always asks for profile email wallets.

ScopeWhat the person sharesNeeds your own appHow it reaches youStatusSource
nftsSee the NFTs in the wallets you linked to MatricaNoSynq reads it at sign-in (coming)ComingDocs
socials.discordSee the Discord account you linked to MatricaNoSynq reads it at sign-in (coming)ComingDocs
socials.twitterSee the X (Twitter) account you linked to MatricaNoSynq reads it at sign-in (coming)ComingDocs
socials.telegramSee the Telegram account you linked to MatricaNoSynq reads it at sign-in (coming)ComingDocs

On this page