API credentials

RippleNet API calls require Bearer authentication tokens that you retrieve from the authentication operation using API credentials.

API Credentials page


Each environment can have up to three credentials.

New credential

To create an API credential:

  1. Select API Credentials in the Developers category of the Settings page.
  2. Click the New Credential button.
  3. Enter a name for your new credential.

API credential dialog box

  1. Click the Save & Generate Key button.

    RippleNet Home presents a dialog box with the client ID and audience that you’ll use with the credential along with the credential.

API credential details


Copy the credential and store it in a secure location to use with API calls. You won’t be able to view it again.

  1. To finish credential creation, click Close.

Rotate credential

Rotating credentials is the process of changing your password and replacing your cryptographic key for accessing RippleNet.

To rotate your RippleNet credential:

  1. Select Rotate Credential from the dropdown menu in the credential card and confirm your choice.

API credential details

  1. Click the Rotate Credential button to confirm.

API credential details

  1. Once again, copy the credential and store it in a secure location because you won’t be able to view it later.