In this article

Overview

You can create applications and subscribe to APIs in the Developer Portal. New subscriptions must be To use an API in the Developer Portal, you must:

1. Create an entry for your application. The application entry holds the Client ID and Client Secret that the server needs to identify your application as an approved consumer of the APIs.

2. Subscribe to the APIs you need to call.

3. Wait for your subscription to be approved. New subscriptions are approved by an Org admin in the Applications tab of the Subscription Manager.

4. Call the APIs using the Bearer authorization scheme with the Client Secret.

Create an Application Entry

1. In the Developer Portal, go to the Applications page, and click Create New Application.                                                                              

...

1. Image Added

2. In the Create Application dialog, enter the Application Name, and select

...

1. Web or Mobile in the Type field. You can also add a description.

...

1. Image Added

2. If you want to subscribe to an API, click Create and Continue. This will open the Create Subscription dialog.
   If not, click Create and Exit to create your application entry and exit the Create Application dialog. 

Subscribe to an API

1. In the Create Subscription

...

1. dialog, use the API Search field

...

1. to find an API you want to subscribe to

...

1. and click the API card to select it.
   After selecting all the APIs you want, click Continue.
   

...

1. NOTE: You can subscribe only to APIs that allow subscription.

   Image Added

2. In the Subscription tab,

...

1. you can add an optional comment to your selected APIs. Click Continue.

...

1. Image Added

2. In the Register tab,

...

1. you will see a summary page of your application entry and the APIs you selected.
   Click Register to submit your application entry and subscription request.

...

1. Image Added

2. On the

...

1. Applications page,

...

1. application entries with pending or approved API subscriptions have a key icon () in addition to the edit

...

1. icon () and delete icon ( ).
   TIP: Click to copy the Client Secret to your clipboard quickly.

   Image Added

2. To show the status of the subscription

...

1. , click on the application entry card. The status can be Active, Revoked, or Pending.

...

1. Image Added

Anchor
edit-app edit-app

Edit an Application Entry

...

1. In the Developer Portal, go to the Applications page, then point and click the target Application card.

   Image Added

2. You can change the Application Name, Type, or Description.

...

1. Image Added

2. You can also

...

1. manage your Client Secret.

   1. Click under Client ID and Client Secret to copy it to your clipboard. Your subscription must already be approved.

   2. Click Refresh Secret to

...

1. 1. extend the expiration date of your secret key by a year

...

1. 1. .

   2. Click Regenerate Secret to generate a new secret key and refresh the expiration.

...

1. 1. Regenerating the secret key updates the secret key of all

...

1. 1. subscriptions associated with this application entry. The new secret key will automatically be saved

...

1. 1. whether you click Save or not.

2. You can also subscribe to more APIs within your Application.

   1. Click the Subscriptions tab.

   2. Click Add Subscriptions.

   3. Click See All to browse through the APIs.

   4. Point and click the target API cards. When you scroll to the bottom of the page, you can see your selected APIs.

   5. Click Continue.

   6. Proceed through the Subscription wizard and click Register.

Call the API Using Your Application’s Client Secret

After your API subscription is approved, you can use your application's client secret as your API Key to access an approved API.

1. Edit your application entry or click the key icon () on your application’s card to copy the Client Secret to your clipboard.

2. When you configure your application to send a request, add the following Authorization request header:

   • For an API published with OAS 2.0:

     Code Block
     Authorization: Bearer <client secret>

   • For an API published with OAS 3.0:

     Code Block
     Authorization: <client secret>

3. Replace <client secret> with the value stored in your clipboard.
   IMPORTANT: This must be the only Authorization request header in your application.

Learn more about the Authorization request header.

Delete an Application Entry

Click the delete icon ( ) to remove an application and application entry and all its API subscriptions. Click Confirm to delete the application. Image Removed

...