This guide is designed for Customers who want to use the Oyster API to directly interact with your own company data on the Oyster platform. This guide will help you create a Developer App and authorize access on the Oyster API.

Create a Developer App

Oyster grants access to API resources based on OAuth2. To access the API, you must first create a Developer App. Individual customers may then grant API access to your Developer App via an Authorization URL.

You must have an account on Oyster to create a Developer App. You can create a Developer App in a Developer Sandbox for development purposes, and will need to then do the same in a production account before using the integration with your company data. You can find more information about requesting and using a Developer Sandbox in this guide.

Follow these steps:

1. Log in to your account.

2. Choose to create a new Oyster Developer App in the Developer Tab.

   

3. You will then be prompted to fill in the information about your developer application.

   1. Name is the application name.
   2. Description is an optional field and can be left blank.
   3. Redirect URL can be any publicly-accessible URL that can be viewed in a browser without redirecting. For example https://google.com. This must start with https.
   4. Choose the appropriate scopes for your application. Don’t include unnecessary scopes as this might discourage customers from authorizing your application.

4. Once submitted, you will see a popup with the Client ID and Client secret.

   1. The Client ID will still be available in the Developer applications list after you submit the page.
   2. Make sure to copy the Client secret before submitting the page as this will not be visible in plain text again! If you misplace the Client secret, you will be able to regenerate a new one in the Developer applications list.
   

Authorize access

Your developer app must be authorized to access any customer data. Authorization must be granted by a Company Admin via the Oyster application.

1. Click on the Authorization URL for your developer app (provided on the Developer Applications page).
2. In the new tab/window, authorize your Developer App to access your company’s data.
3. This will redirect your browser to the Redirect URL specified in your developer app (e.g. google.com).
4. The redirect will include a code parameter, which is the Authorization code required by the next step to create an Access Token. Make sure to copy this code. You don’t need anything more from that browser window, so you can close it.