Mountain Surfer Drone Racing Game - EOS client returns auth.client_not_found

Issue Summary

I am integrating Epic Online Services into my Unreal Engine 5.7 Windows game, Mountain Surfer Drone Racing Game, using Unreal’s Online Services EOS / EOSGS plugins. I am trying to use EOS Stats and Leaderboards.

Unreal successfully initializes the Epic Online Services provider, and the Auth, Stats, and Leaderboards interfaces are all valid. However, the EOS SDK repeatedly fails client authentication with HTTP 401 and reports that the configured client cannot be found.

EOS Error

ServiceName=[EOSAuth]

OperationName=[TokenGrant]

HttpStatus=[401]

ErrorCode=[errors.com.epicgames.eos.auth.client_not_found]

NumericErrorCode=[110002]

ErrorMessage=[Client not found: xyza7891cs2aXMFKVy2tNJV9u38EyL06]

LogEOSAnalytics: Unable to get the client auth token.

Last result: EOS_InvalidCredentials.

SDK Config Product Update Request Failed,

Result Code: EOS_InvalidCredentials

EOS Configuration

Setting

Value

Product ID

242e8002c056467a901f912d76c69574

Dev Sandbox ID

p-m4s5evfmq9ubgkurd55vr3jrn76dsb

Dev Deployment ID

4399af80e70a49af9eefce7d172d2635

Client

MountainSurfer_GameClient

Client ID

xyza7891cs2aXMFKVy2tNJV9u38EyL06

Client Policy

MountainSurfer_GameClient

Client Policy Type

GameClient

client_not_found means the EOS backend doesn’t recognize the Client ID the SDK sent (xyza7891cs2aXMFKVy2tNJV9u38EyL06). Unreal is passing your configured value through correctly, so the issue is which credentials are configured.

The most common cause is accidentally using the BPT (BuildPatchTool) client credentials. That client is for uploading builds and can’t be used with the EOS SDK. In the Developer Portal, go to Product Settings > Clients, copy the Client ID and Secret of an EOS SDK client (your GameClient-policy client), and put them in your EOS config. The ID and secret must come from the same client.

Also make sure no other config layer overrides ClientId with an old value.

Once login works, make sure the Client Policy allows the Stats and Leaderboards actions you use.

https://dev.epicgames.com/docs/epic-online-services/sdk-error-codes

https://dev.epicgames.com/docs/epic-online-services/eos-fundamentals/client-and-client-policy