Errors and limits

What can go wrong, and how often you may call.

OAuth errors

errorStatusMeaning
invalid_request400 / redirectMissing or bad parameter (e.g. no PKCE for a public client).
invalid_client401Unknown client id or wrong secret.
invalid_grant400Code or refresh token invalid, expired, reused, or the player removed your app. Sign in again.
invalid_scope400 / redirectUnknown scope, or one your app may not request.
unsupported_grant_type400grant_type not supported.
access_deniedredirect / 400The player declined.
consent_requiredredirectprompt=none but the player hasn't allowed your app.
authorization_pending, slow_down, expired_token400Device flow
temporarily_unavailable503Try again later.

Social API errors

Statuserror / codeMeaning
401invalid_tokenMissing, expired or revoked token. Refresh once; if that fails, sign in again.
403insufficient_scopeThe token lacks the scope this endpoint needs (see WWW-Authenticate).
403not_friendsInvites are only between friends.
404—Not found (e.g. an invite that isn't yours).
410expiredThe invite expired or was already answered.
429—Rate limited. Wait and retry; see below.

Rate limits

WhatLimit
Any endpoint600 requests per IP per 10 minutes
Token endpoint300 per IP per 10 minutes
Device codes60 per IP per 10 minutes
Presence updates120 per player per 10 minutes
Invites sent30 per player per 10 minutes

Players behind one network share the per-IP budget; the SDK defaults (presence every 60 s, events every 10 s) stay well inside it.