Start connecting a Google account: returns the Google consent URL to open in a browser
POST
/meta/v1/connections/authorize
Human only: a person connects their own mailbox, because someone has to be at Google’s consent screen. The URL is valid for ten minutes. When the person has consented, Google sends the browser back to the vault, which records the connection, its encrypted credential and the mailbox addresses as own identities; nothing is read from the mailbox yet. Answers 501 provider_not_configured when the deployment has no Google OAuth client.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
provider
required
string
Responses
Section titled “ Responses ”Success
object
authorize_url
required
Open this URL in a browser: Google’s consent screen. The vault records the connection when Google sends the person back.
string
expires_at
required
When the link stops working (ten minutes).
string