# Start an OAuth connection

> 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.

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

<RequestSchema
  {...require("./create-oauth-connection.RequestSchema.json")}
>

<StatusCodes
  {...require("./create-oauth-connection.StatusCodes.json")}
>
