Initiate Oauth

Initiate an OAuth authentication flow.

This endpoint generates an authorization URL that the user should visit to grant permissions to the integration.

Flow:

1. Call this endpoint with the integration ID
2. Redirect the user to the returned auth_url
3. User grants permissions on the provider’s website
4. Provider redirects back to the callback URL with a code
5. Callback handler exchanges code for tokens and creates connection

Example:

POST /oauth/initiate
{
    "integration_id": "gmail",
    "auth_method_id": "oauth2",
    "scopes": [
        "https://www.googleapis.com/auth/gmail.readonly",
        "https://www.googleapis.com/auth/gmail.send"
    ]
}

Response:

{
    "auth_url": "https://accounts.google.com/o/oauth2/v2/auth?...",
    "state": "abc123...",
    "integration_id": "gmail"
}