Skip to main content

Start an OAuth connection

POST 

/api/v1/oauth-connections

Starts the authorization of an actor through an OAuth client and returns the authorize_url to send the person to; it is single-use and expires after 10 minutes. Starting again for the same actor and client restarts the same connection (200), and a connected one keeps its tokens until the new authorization completes. Hand the authorize_url only to the person the actor is: whoever consents connects their account to that actor.

Request​

Responses​

The existing connection, restarted