Skip to Content

Getting started with the SAP API Business Hub


Getting started with the SAP API Business Hub

By Meredith Hassett

Learn how to find and test the API Business Hub.

You will learn

Want to learn more about the new SAP API Business Hub? Not sure where to get started? Find more about how to find and enable the SAP API Business Hub in your SAP Cloud Platform instance. Once you are in the SAP API Business Hub, start learning about and testing one of the many available APIs.


Step 1: Open SAP Cloud Platform Services

Open your SAP Cloud Platform Cockpit. If you do not have an account yet, sign up for a free trial account first.

In your SAP Cloud Platform account, select Services from the side menu.

service in SAP Cloud Platformmenu
Please log in to access this content.
Step 2: Open SAP API Business Hub

In the Services catalog, search for SAP API. You should see 2 results. The SAP API Business Hub is the service you are looking for.

API Services in HCP

Select the SAP API Business Hub service. If it is not already enabled, do so on the service page.

Once the service is enabled, select Go to Service.

SAP Cloud Platform API Business Hub page

This will direct you to the homepage for the SAP API Business Hub.

SAP API Business Hub homepage

You can access the SAP API Business hub through SAP Cloud Platform or by just visiting their website by going to

Please log in to access this content.
Step 3: Find an API Package in the Hub

On the SAP API Business Hub homepage, select APIs to see the available packages in the API Business Hub.

SAP API Business Hub homepage API tile

In the API Packages explorer, find the SAP Success Factors API Package. You will be using this package for testing and the following tutorials in this series. Select the Success Factors package.

API Packages with Success Factors selected

The Success Factors contains 14 APIs that can be used. APIs are grouped into Business Packages so they are easier to find and

Please log in to access this content.
Step 4: Select an API to use

In the Success Factors package, look for the User Information API.

User API in the Success Factors package

Select this API.

Once you click the API, you will see all the available methods for the API. In the User Information API, you have 4 methods. Click on the first Get method, GET /User.

API Packages with Success Factors selected

When you click the method, you are able to see all the query parameters and their corresponding documentation, such as what data type is expected and what the parameter is used for.

Please log in to access this content.
Step 5: Test the API in the Hub

In order to test the API in the API Business Hub, you need to login. Click the Login icon at the top of the page to do so.

Login link in SAP API Business Hub

When you look at the API Documentation again for the GET /User method, you will see that the value field has become an editable field. You can test different query parameters by providing a value in the input of the specified data type for that parameter.

editable fields for query parameter testing

The GET /User method will return a list of users from Success Factors. That could be a long list, so set the $top parameter to 5. The top parameter tells the query to retrieve only the top n results once all the other filtering is done. In the $select parameter, using the control key for Windows or command key for Macs, select firstName, lastName, and jobTitle. This will limit the data set returned to this 3 fields for the matching results. If you don’t need to see all a users data, only select data points, you can use the $select parameter to pick the data you want. This will help reduce the size of the resulting data set if performance is an issue.

Query parameters populated in the API Hub

Once your parameters are all set, click the Try it out button at the bottom of the documentation for that method.

Try it out button location

If there aren’t any issues, you will see the resulting request URL and the response body (in JSON) on your page.

successful result from query

Feel free to keep playing around in the SAP API Business Hub to better understand the methods available in the User Information API.

Please log in to access this content.

Next Steps

Updated 04/11/2017

Time to Complete

15 Min.



Back to top