Skip to content

Headers ​

Send this set on authenticated ubi-services calls unless an endpoint page says otherwise. Endpoint pages do not repeat this table.

http
Authorization: ubi_v1 t={ticket}
Ubi-AppId: {appId}
Ubi-SessionId: {sessionId}
Ubi-RequestedPlatformType: uplay
Ubi-LocaleCode: en-US
Content-Type: application/json
User-Agent: Mozilla/5.0
HeaderRequiredNotes
AuthorizationYesubi_v1 t={ticket} or Ubi_v1 t={ticket} after login; Basic {base64(email:password)} on password login; Ubi_2fa_v1 t={twoFactorAuthenticationTicket} (or ubi_2fa_v1) on complete 2FA
Ubi-AppIdYesMust match the ticket's app. Casing Ubi-AppId / Ubi-appid both work. See App IDs
Ubi-SessionIdUsuallyUUID from the Session
Ubi-RequestedPlatformTypeUsuallyuplay for PC. Other clients send xbl, psn, steam, etc.
Ubi-LocaleCodeNoen-US / en-GB
Content-TypeOn bodiesapplication/json
User-AgentSoftBrowser UA, or UbiServices_SDK_2022.Release.39_PC64_ansi_static on some SDK clients
ubi-2facode / Ubi-2FACode2FASix-digit code on complete 2FA and some account 2FA writes
GenomeIdMail-link / familyUnauthenticated activation, email change, password reset, and family calls from account.ubisoft.com
UserIdSSOPOST SSO refresh when resolving an SSO id from a ubi userId
Ubi-TransactionIdSMS resetPassword reset completed by SMS

Optional extras ​

Seen on a subset of routes (presence, inventory, GraphQL, geo):

http
ubi-regionid: WW
ubi-countryid: US
ubi-profileid: {userId}
x-platform-appid: {platformAppId}
Origin: https://connect.cdn.ubisoft.com
apollographql-client-version: 1.56.1
Accept-Encoding: gzip, deflate, br

Only set these when the endpoint page mentions them.

reCAPTCHA challenge ​

Account.ubisoft.com sensitive writes send:

http
Ubi-Challenge: cce={base64("sitekey={siteKey}&token={token}")}

1301 in the error body means the challenge was required or rejected. See Errors.

Some mail-link and family routes also send GenomeId. SSO refresh from the account site sends UserId.

Connect vs ubi-services ​

connect.ubisoft.com is two different things:

SurfaceAuth
Cross-channel SSO (/v2/crosschannelauth/…, check2fa)Website SSO cookies
Account-site Connect APIs (countries, avatars, catalog, games played, profile stats)Same ubi_v1 ticket set as ubi-services

Don't send the ticket set to the SSO routes and expect it to replace cookies. Do send it to the account-site Connect REST routes — those are ticket APIs that happen to live on the Connect host.

Unofficial community documentation. Not affiliated with Ubisoft.