Start OAuth connect
Start connecting a Google Workspace or Microsoft mailbox over OAuth. Returns a consent URL to open in a browser, plus a state handle. Once the owner grants access, poll GET /v1/accounts/oauth/{provider}/status?state=….
Requires one of the following scopes: accounts:write, accounts:all, all:all.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
google, microsoft Response
Open this consent URL in a browser so the mailbox owner can grant access.
"https://accounts.google.com/o/oauth2/v2/auth?client_id=…&state=…"
Opaque handle. Pass it to the status endpoint to poll the result.
"aB3dEf6hIjKlMnOpQrStUvWxYz0123456789_-AbCdE"
How long the consent link / state stays valid.
600