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.
Synq always asks for openid email profile.
| Scope | What the person shares | Needs your own app | How it reaches you | Status | Source |
|---|---|---|---|---|---|
https://www.googleapis.com/auth/user.birthday.read | See your date of birth | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
https://www.googleapis.com/auth/profile.agerange.read | See your age range | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
https://www.googleapis.com/auth/user.phonenumbers.read | See the phone numbers on your Google Account | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
https://www.googleapis.com/auth/user.addresses.read | See the street addresses on your Google Account | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
https://www.googleapis.com/auth/profile.language.read | See which language you prefer | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
https://www.googleapis.com/auth/user.organization.read | See the work and education history on your Google profile | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
https://www.googleapis.com/auth/calendar.freebusy | See when you’re free or busy in Google Calendar, but not your events | Yes | Needs the person’s provider token (coming) | Coming | Docs |
https://www.googleapis.com/auth/calendar.events.readonly | See the events on your Google calendars | Yes | Needs the person’s provider token (coming) | Coming | Docs |
https://www.googleapis.com/auth/calendar.app.created | Make a calendar of your brand’s own in Google Calendar and manage its events | Yes | Needs the person’s provider token (coming) | Coming | Docs |
https://www.googleapis.com/auth/calendar.events.owned | Add, change and delete events on the Google calendars you own | Yes | Needs the person’s provider token (coming) | Coming | Docs |
https://www.googleapis.com/auth/calendar.events | Add, change and delete events on all your Google calendars | Yes | Needs the person’s provider token (coming) | Coming | Docs |
https://www.googleapis.com/auth/contacts.readonly | See your Google contacts | Yes | Needs the person’s provider token (coming) | Coming | Docs |
https://www.googleapis.com/auth/drive.file | See and change only the Google Drive files you open or create with your brand | Yes | Needs the person’s provider token (coming) | Coming | Docs |
https://www.googleapis.com/auth/drive.appdata | Keep your brand’s own settings in a hidden folder in your Google Drive | Yes | Needs the person’s provider token (coming) | Coming | Docs |
https://www.googleapis.com/auth/tasks.readonly | See your Google Tasks | Yes | Needs the person’s provider token (coming) | Coming | Docs |
https://www.googleapis.com/auth/tasks | Add, change and delete your Google Tasks | Yes | Needs the person’s provider token (coming) | Coming | Docs |
https://www.googleapis.com/auth/youtube.readonly | See your YouTube account and channel | Yes | Needs the person’s provider token (coming) | Coming | Docs |
GitHub
Synq always asks for read:user user:email.
| Scope | What the person shares | Needs your own app | How it reaches you | Status | Source |
|---|---|---|---|---|---|
read:org | See which GitHub organizations and teams you belong to | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
read:public_key | See the SSH keys on your GitHub account | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
read:gpg_key | See the GPG keys on your GitHub account | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
read:project | See your GitHub Projects boards, and your organizations’ boards | Yes | Needs the person’s provider token (coming) | Coming | Docs |
read:packages | Download packages you can get from GitHub Packages | Yes | Needs the person’s provider token (coming) | Coming | Docs |
gist | Create and edit your gists for you | Yes | Needs the person’s provider token (coming) | Coming | Docs |
notifications | See your GitHub notifications, mark them read, and watch repositories | Yes | Needs the person’s provider token (coming) | Coming | Docs |
Microsoft
Synq always asks for openid email profile User.Read.
| Scope | What the person shares | Needs your own app | How it reaches you | Status | Source |
|---|---|---|---|---|---|
Calendars.ReadBasic | See the times, titles and places of your Outlook events, but not their details | Yes | Needs the person’s provider token (coming) | Coming | Docs |
Calendars.Read | See the events in your Outlook calendar | Yes | Needs the person’s provider token (coming) | Coming | Docs |
Calendars.ReadWrite | Add, change and delete events in your Outlook calendar | Yes | Needs the person’s provider token (coming) | Coming | Docs |
MailboxSettings.Read | See your Outlook settings, like your time zone, language and working hours | Yes | Needs the person’s provider token (coming) | Coming | Docs |
Contacts.Read | See your Outlook contacts | Yes | Needs the person’s provider token (coming) | Coming | Docs |
Files.Read | See the files in your OneDrive | Yes | Needs the person’s provider token (coming) | Coming | Docs |
Files.ReadWrite.AppFolder | Keep your brand’s own files in a folder of its own in your OneDrive | Yes | Needs the person’s provider token (coming) | Coming | Docs |
Files.ReadWrite | See, add, change and delete the files in your OneDrive | Yes | Needs the person’s provider token (coming) | Coming | Docs |
Tasks.Read | See your Microsoft To Do tasks | Yes | Needs the person’s provider token (coming) | Coming | Docs |
Tasks.ReadWrite | Add, change and delete your Microsoft To Do tasks | Yes | Needs the person’s provider token (coming) | Coming | Docs |
OnlineMeetings.ReadWrite | Create Microsoft Teams meetings for you | Yes | Needs the person’s provider token (coming) | Coming | Docs |
Presence.Read | See whether you’re available, busy or away in Microsoft Teams, with your status note | Yes | Needs the person’s provider token (coming) | Coming | Docs |
Apple
Synq always asks for openid name email.
Apple has nothing more to ask for: Synq's minimum covers every scope it has.
Synq always asks for email public_profile.
| Scope | What the person shares | Needs your own app | How it reaches you | Status | Source |
|---|---|---|---|---|---|
user_age_range | See your age range from Facebook | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
user_birthday | See your birthday | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
user_friends | See which of your Facebook friends also use your brand | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
user_link | See the link to your Facebook profile | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
user_location | See the city on your Facebook profile | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
user_hometown | See your hometown from your Facebook profile | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
user_gender | See the gender on your Facebook profile | Yes | Synq reads it at sign-in (coming) | Coming | Docs |
user_likes | See the Facebook Pages you’ve liked | Yes | Needs the person’s provider token (coming) | Coming | Docs |
user_photos | See the photos you’ve uploaded to Facebook | Yes | Needs the person’s provider token (coming) | Coming | Docs |
user_videos | See the videos you’ve uploaded to Facebook | Yes | Needs the person’s provider token (coming) | Coming | Docs |
user_messenger_contact | Let your brand’s Facebook Page message you on Messenger | Yes | Needs the person’s provider token (coming) | Coming | Docs |
X
Synq always asks for users.read tweet.read users.email.
| Scope | What the person shares | Needs your own app | How it reaches you | Status | Source |
|---|---|---|---|---|---|
tweet.write | Post and repost on X for you | Yes | Needs the person’s provider token (coming) | Coming | Docs |
media.write | Upload photos and videos to X for you | Yes | Needs the person’s provider token (coming) | Coming | Docs |
follows.read | See who you follow and who follows you on X | Yes | Needs the person’s provider token (coming) | Coming | Docs |
like.read | See the posts you’ve liked on X | Yes | Needs the person’s provider token (coming) | Coming | Docs |
bookmark.read | See your bookmarked posts on X | Yes | Needs the person’s provider token (coming) | Coming | Docs |
bookmark.write | Bookmark posts for you and remove bookmarks | Yes | Needs the person’s provider token (coming) | Coming | Docs |
list.read | See your X Lists, including private ones | Yes | Needs the person’s provider token (coming) | Coming | Docs |
block.read | See the accounts you’ve blocked on X | Yes | Needs the person’s provider token (coming) | Coming | Docs |
mute.read | See the accounts you’ve muted on X | Yes | Needs the person’s provider token (coming) | Coming | Docs |
space.read | See the Spaces you can view on X | Yes | Needs the person’s provider token (coming) | Coming | Docs |
tweet.moderate.write | Hide and unhide replies to your posts | Yes | Needs the person’s provider token (coming) | Coming | Docs |
Discord
Synq always asks for identify email.
| Scope | What the person shares | Needs your own app | How it reaches you | Status | Source |
|---|---|---|---|---|---|
guilds | See which Discord servers you’re in | No | Synq reads it at sign-in (coming) | Coming | Docs |
guilds.members.read | See your nickname, roles and join date in Discord servers you’re in | No | Synq reads it at sign-in (coming) | Coming | Docs |
connections | See the other accounts you’ve linked to Discord, like Steam or YouTube | No | Synq reads it at sign-in (coming) | Coming | Docs |
guilds.join | Add you to your brand’s Discord server | Yes | Needs the person’s provider token (coming) | Coming | Docs |
role_connections.write | Show your your brand account details in Discord so servers can give you roles | Yes | Needs the person’s provider token (coming) | Coming | Docs |
Telegram
Synq always asks for openid profile.
| Scope | What the person shares | Needs your own app | How it reaches you | Status | Source |
|---|---|---|---|---|---|
phone | See the phone number on your Telegram account | No | In the ID token, kept on the identity | Available | Docs |
telegram:bot_access | Let your brand’s Telegram bot send you messages | Yes | A permission at the provider, used with your own credentials | Available | Docs |
Matrica
Synq always asks for profile email wallets.
| Scope | What the person shares | Needs your own app | How it reaches you | Status | Source |
|---|---|---|---|---|---|
nfts | See the NFTs in the wallets you linked to Matrica | No | Synq reads it at sign-in (coming) | Coming | Docs |
socials.discord | See the Discord account you linked to Matrica | No | Synq reads it at sign-in (coming) | Coming | Docs |
socials.twitter | See the X (Twitter) account you linked to Matrica | No | Synq reads it at sign-in (coming) | Coming | Docs |
socials.telegram | See the Telegram account you linked to Matrica | No | Synq reads it at sign-in (coming) | Coming | Docs |