To set up the API Management capability from Integration Suite, you should first have an Integration Suite subscription.
IMPORTANT Ensure that you don’t have an instance of starter plan created in the same subaccount, where you plan to create an Integration Suite subscription. Also, note that API Management capabilities from Integration Suite and API Management subscriptions using the standalone tile cannot coexist in the same subaccount.
Step 1Subscribe to Integration Suite
โ
Log on to SAP BTP Cockpit and navigate to your subaccount.
In the navigation area of the subaccount, choose Services > Service Marketplace. Search for Integration Suite and choose Create.Integration Suite Tile
On the New Instances and Subscriptions dialog, select the Service and the Plan and choose Create.
Wait for the subscription to complete successfully.Create Integration Suite Subscription
Choose View Subscription on the Creation in Progress dialog.Creation of Integration Suite Subscription in ProgressCheck the status of the submission in subscriptions section on the Instances and Subscriptions page. If the subscription is successful you’ll notice the status of the Integration Suite shown as Subscribed.
To access Integration Suite, you must first assign the “Integration Provisioner” role to yourself.
IMPORTANT If you choose Go to Application without assigning the Integration Provisioner role, an application authentication error appears. If the error persists after assigning the role, clear your web browser cache and log out of the application and log in again.
Step 2Assign the Integration Provisioner Role
+
On the navigation pane, choose Security > Users.Assign Role
Select the user to whom you want to assign the role, and under Role Collections section, choose Assign Role Collection.Assign Role Collection
In the resulting dialog box, select the Integration_Provisioner role and choose Assign Role Collection.Assign Integration Provisioner Role
Step 3Get Directed to Integration Suite Homepage
+
Once the Integration Provisioner role is assigned, choose Instances and Subscriptions on the left navigation pane.
Under Subscriptions look for Integration Suite, and choose Go To Application.Getting directed to Integration Suite Homepage
Step 4Activate API Management Capability
+
On the Integration Suite home page, under Capabilities, choose Add Capabilities.Add Capabilities
To design, develop, publish, and oversee APIs in a secure and scalable environment, choose Manage APIs and choose Next on the Activate Capabilities dialog.Add API Management Capability
To discover, consume and monitor APIs from a centralized API catalogue, select the checkbox Developer Hub.
Once you enable Developer Hub, you will get an option to enable Graph.Activate Developer Hub
If you want to expose all your business data in the form of a single semantically connected data graph, select the checkbox for Graph, and choose Next.Activate Developer Hub
Choose Activate on the Activate Capabilities dialog.API Portal and Developer Hub is Active
On the resulting screen, choose OK once the status changes from In Progress to Active.API Portal and Developer Hub is Active
Go to the SAP BTP Cockpit, choose Security > Users and select the user to whom you want to assign the role. Under Role Collections section, choose Assign Role Collection. In the resulting dialog box, choose the following roles and choose Assign Role Collection:
APIManagement.Selfservice.Administrator - This role is required to configure API Management service in Integration Suite.
AuthGroup.SelfService.Admin - This role is required during the onboarding of Developer Hub and to get access to it.
Graph.KeyUser - This role is required to create and activate business data graphs for a landscape.
GraphNavigator.Viewer - This role is required to explore business data graphs in Graph Navigator.
Refresh the Integration Suite page. If you don’t see the APIs option under the Settings tab, log out of the Integration Suite page and log in again.
Step 5Configure the API Management Service
+
On the Integration Suite home page, choose Settings > Runtimes from the left navigation pane.Setting Up API Management Service
On the Configure the API Management Service page, configure the following and choose Activate:
Select the Account type:
Select Non-Production account type for non-business critical activities.
Select Production account type for business-critical usage.
In the Virtual Host section, enter the Host Alias.
Provide an email ID in Notification Contact to receive updates.
Configure the API Management Service
In the Set-up Confirmation window, review the provided details and choose Confirm to start the onboarding process.Configure the API Management ServiceYou’re redirected to a progress window, which states API Management Service Setup In Progress.
The Configuration process is triggered, where the necessary resources are provisioned for you. It’s followed by Testing the Setup, where a simple API Proxy is deployed and invoked to check that everything is set up properly.
When the processes complete, the indicators turn green to indicate that the processes are successful. A Release Notification email is sent out to the email ID, which you provided earlier in the process in the Configure the API Management Service screen. This e-mail contains details of the newly set up API Management service on your account.Completion of API Management Onboarding
Log out of the Integration Suite and login again.Welcome to API Management Service
You can now create APIs, build API proxies as a service provider, or use APIs and other convenient services.
Share feedback on this tutorial or join the conversation in SAP Community.
Submit detailed feedbackDiscuss in Community
Steps
Step 1 of 5
1. Subscribe to Integration Suite2. Assign the Integration Provisioner Role3. Get Directed to Integration Suite Homepage4. Activate API Management Capability5. Configure the API Management Service
Joule
AI Notice
Joule is an AI assistant. Generative AI may produce inaccurate, incomplete, or biased information. Always verify important details before acting on them.
Conversations are sent to SAP-hosted large language models for processing. Do not include personal data, credentials, or confidential information in your messages.
Joule's responses are based on the SAP tutorial catalog and may not reflect the latest product changes. For authoritative guidance, consult the linked tutorials and official SAP documentation.