Skip to content

OAuth clients

An OAuth client gives your integration a client_id and client_secret. Your integration uses them to request access tokens for the Trading API. See Authorization for how to request and use a token.

To open the page, go to Settings → OAuth clients.

The page shows a card for each OAuth client of the selected bookmaker. Each card shows:

  • the label;
  • the status: active or revoked;
  • the Client ID, with a copy button;
  • Created at.

The secret is not shown on the card.

Generate a new OAuth client

  1. Click Generate new.
  2. In the Generate new OAuth client dialog, enter a label for the OAuth client, for example the name of the integration.
  3. Click Generate.
  4. The dialog shows the Client ID and the Secret. Copy them.
  5. Click Close.

The dialog also shows a curl command that requests an access token with the new credentials. You can copy it and run it to check that the OAuth client works.

Copy the secret now — it is shown only once

The secret is shown only in this dialog. After you click Close, you cannot see it again. If you lose it, generate a new OAuth client and revoke the old one.

Revoke an OAuth client

  1. On the card of the OAuth client, click Revoke.
  2. Click Revoke to confirm.

You cannot undo this. The OAuth client gets the revoked status and cannot request new access tokens. Tokens that it already received keep working until they expire, up to 1 hour.

To replace an OAuth client without downtime, generate a new one first, switch your integration to it, and then revoke the old one.