External Credentials Exchange

Before using this method, you must configure your identity provider in the Developer Portal. Exchange the external provider's token for a Discord access token from your game server:

# filepath: your_game/server/auth.py
import requests

def get_provisional_token(external_token: str):
  response = requests.post(
    'https://discord.com/api/v10/partner-sdk/token',
    json={
      'client_id': CLIENT_ID,
      'client_secret': CLIENT_SECRET,
      'external_auth_type': EXTERNAL_AUTH_TYPE,  # See External Auth Types
      'external_auth_token': external_token
    }
  )
  return response.json()

See the External Auth Types table for the full list of supported external_auth_type values.

{
  "access_token": "<access token>",
  "id_token": "<id token>",
  "token_type": "Bearer",
  "expires_in": 604800,
  "scope": "sdk.social_layer"
}

sequenceDiagram
    autonumber
    actor P as Player
    participant Prov as External Provider<br/>(OIDC, Steam, EOS)
    participant G as Your Game Server
    participant D as Discord API

    P->>Prov: Authenticate
    Prov-->>G: External auth token
    G->>D: POST /partner-sdk/token<br/>{ client_id, client_secret,<br/>external_auth_type, external_auth_token }
    alt No account for identity
        D->>D: Create provisional account
        D-->>G: 200 { access_token, id_token, ... }
    else Provisional account exists
        D-->>G: 200 { access_token, id_token, ... }
    else Full Discord account exists
        D-->>G: Error 530010 (use OAuth2 flow)
    end

Once authentication is complete, you can use the access token as you would a full Discord user's access token. See Managing Provisional Accounts for token refresh, storage, and display names.

Common error codes and solutions when creating a provisional account:

If you are using OIDC, you may encounter more specific errors:

Need help? Join the Discord Developers Server and share questions in the #social-sdk-dev-help channel for support from the community.

If you encounter a bug while working with the Social SDK, please report it here: https://dis.gd/social-sdk-bug-report