Sign In with Google
horizon_signin_googleSigns an existing Google player in by exchanging a fresh OAuth authorization code for a player session; use after a known user completes consent.
Instructions
Signs an existing Google player in by exchanging one fresh authorization code for a player session. Use when: a known Google player completes OAuth and requests signin. Not for: an unknown/new player: use horizon_signup_google with signInIfExists=true for one-click registration/signin instead of probing with this tool. Side effects: exchanges the Google code once and creates a session; no automatic signup, retries or provider UI. Returns: user details, authStatus: AUTHENTICATED and accessToken, plus refreshToken and both expiry timestamps only with includeRefreshToken=true. Errors: 404 USER_NOT_FOUND requires a fresh OAuth code before signup. Never reuse this code after an error or lost response. 400 for invalid provider data, 403 for an unavailable user. Needs HORIZON_API_KEY. Every failure returns an error result (isError) with the HTTP status and body: a 401 that horizon_test_connection also returns means HORIZON_API_KEY is wrong, 429 means the account's per-minute rate limit was reached (wait a minute, then retry).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"googleAuthorizationCode": "<googleAuthorizationCode>",
"googleRedirectUri": "<googleRedirectUri>"
},
"name": "horizon_signin_google"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| googleRedirectUri | Yes | Exact redirect URI used to obtain the Google authorization code; empty string for configured native flows (max 500 characters) | |
| includeRefreshToken | No | Explicit opt-in to a rotating 30-day refresh session; omitted or false preserves access-only behavior. Store refresh tokens in platform secure storage | |
| googleAuthorizationCode | Yes | Fresh single-use Google authorization code obtained by the player's OAuth consent flow (max 2000 characters) |