Create an OAuth 2.0 client

Navigate to your TARTLE Developer Settings page on the 'OAuth App' tab. You can then click on 'New App' to begin the process of creating a new DataVault OAuth 2.0 client.

In the client creation modal form, you'll need to provide the following information:

  • Application Name: This is what your users will see in the OAuth 2.0 consent screen, make it recognizable.
  • Application Description: A short description of what your application does, this will be displayed in a list of installed apps for users that use your client and how some of them will evaluate its usefulness if they are thinking about revoking access, so make it count.
  • Redirect URI: The URI to redirect to after the user has authenticated.

Example of good values for the form fields

Application Name: Acme Receipts Sync
Application Description: Sync your receipts from Acme to TARTLE, we will create a data packet of
  your receipts so you can receive bids from our trusted partners. You can then sell this data to
  the partners you choose. Unleash the value of your data.
Redirect URI: https://acme-receipts.com/auth/callback

Once you've filled out the form, click on 'Save' to create your client. You will be shown a modal with your client_id and client_secret. Read the instructions carefully.

Please don't save your client_secret to a GitHub or any other respository. Best practice is to save it in a secure environment like AWS Secrets Manager for use in your application and a password manager for reference.

Was this page helpful?