Sign Up with Apple
horizon_signup_appleCreates a new Apple player account from a consented identity token after sign-in returns USER_NOT_FOUND, with optional first-login name and refresh session. It does not auto-link accounts.
Instructions
Creates an Apple player with a consented identity token and optional first-login name fields. Use when: horizon_signin_apple returned USER_NOT_FOUND and the player explicitly agrees to create the account. Not for: signup after any other Apple failure, dashboard-account login, or automatic account linking. Requires: Apple Sign-In enabled for this project API key with matching Team ID, Services ID and/or Bundle ID in the dashboard, and an identity token from the app's native or browser consent flow. Side effects: creates a player. The server derives the name from appleFirstName/appleLastName or the token; use horizon_change_name for an override. No session without refresh opt-in. Returns: 201 with userId, appleUserId, isPrivateRelayEmail, isVerified and authStatus. includeRefreshToken=true also issues accessToken, refreshToken and both expiry timestamps. Otherwise call horizon_signin_apple after signup. Errors: 400 INVALID_APPLE_TOKEN or APPLE_NOT_CONFIGURED requires fixing the token/configuration, 409 means identity/email conflict. Do not create or link another account automatically. 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": {
"appleIdentityToken": "<appleIdentityToken>"
},
"name": "horizon_signup_apple"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appleLastName | No | Optional family name from Apple's first consent response (max 50 characters); Apple may not send it again | |
| appleFirstName | No | Optional given name from Apple's first consent response (max 50 characters); Apple may not send it again | |
| appleIdentityToken | Yes | Apple identity-token JWT obtained after player consent, with audience matching this project's configured Services ID or Bundle ID | |
| 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 |