How to Manage a Third-Party CRM with SAP Integration Suite

To streamline integration in hybrid and multicloud environments, SAP Integration Suite can be leveraged as a single platform for managing your APIs and connector instances.


You can discover your Open Connectors instances in the API portal and then create API proxies for these instances, which you can later strengthen using the rich set of policies available as part of the API Management capability. In the following sections, we’ll use the Common Resources templates to map necessary fields in Open Connectors, create a provider in API Management, discover the Open Connectors instance, and finally manage it using out-of-the-box policies.


Creating a Common Resources Template

Let’s connect a HubSpot CRM instance, as shown in this figure.


HubSpot CRM


In this section, we’ll show how to create and test a template for a third-party HubSpot instance via the Common Resources view. In our example, we’ll use the basic-companies common resource template that is premapped to multiple non-SAP connectors from the CRM hub via a normalized interface for the accounts or companies entity, providing basic information like name, description, phone, website, shipping address, and billing address. Follow these steps to clone the template:

  1. From your Open Connectors capability home or landing page, click the Common Resources tab and then select the Common Resource Templates tab to view and explore all the preshipped common resource templates, as shown below.

Common Resources

  1. Select the companies tile and then select Mappings, as shown in this figure.

Mapping Companies

  1. Select Clone to open the Clone Into popup. Here you can copy or clone the selected common resource template, as shown in the next figure, to your Open Connectors tenant of SAP Integration Suite. Select the checkbox next to Connector Name to select all the connectors, then click Save & Next.

Cloning Common Resource Template

  1. Select the level (account) and click Save & Next, as shown here.

Clone Info

  1. Provide a unique name for the cloned common resource and click Save & Next to complete the setup.

Now your common resource template is created. To test it, follow these steps:

  1. Select the connector instance for HubSpot that you have in your Open Connectors tenant, as shown below.

Test Common Resource Template

  1. Select a non-SAP CRM connector instance, like myhubspotdemo, and select Try it Out to test the common resources, as shown here.

HubSpot CRM Instance

  1. All the necessary fields are automatically filled in. Click Execute to test the common resources template, as shown in in this figure.

Execute Common Resources Template


Managing the HubSpot Instance Using API Management

You’ve now set up your common resources template and created the HubSpot instance. To manage your HubSpot instance using the API Management capability, follow these steps:

  1. Navigate to your API portal.
  1. Navigate to Configure and click the Create button, as shown in this figure.

Create Provider

  1. In the Overview section, give a name for a provider.
  1. Go to the Open Connectors capability and copy the Organization Secret and User Secret for the HubSpot instance you created in the previous section by clicking Settings (the gear icon), as shown in this figure.

Open Connectors Credentials

  1. In API Management, switch to the Connection tab, as shown below. Select Open Connectors from the Type dropdown, choose your Region, enter your Host (your Open Connectors host), enter your Port (443), and paste the Organization Secret and User Secret. Click Save.

Connectors Details in API Management

  1. You can test the connection for this Open Connectors instance of SAP Integration Suite by clicking the Test Connection button, shown here.

Testing Connection


Discovering the Open Connectors Instance

Next, we’ll discover the Open Connectors instance that we’ve created. Follow these steps:

  1. Navigate to Develop and click the Create button, as shown here.

Create API Proxy Pointing to Open Connectors Instance

  1. Select the API provider pointing to the Open Connectors instance that you created in the previous section. Click Discover to discover the associated APIs, as shown in this figure.

Discover Open Connectors Instance

  1. Create an API proxy by selecting the HubSpot CRM connector (MyHubSpot, shown at the top of the next figure).

Select Instance

  1. Select the instance you created from the list, as shown in the lower portion of the above figure, and click OK.
  1. All the necessary details will be prefilled. Click Create and then click OK, as shown here.

Deploy Proxy

  1. Once you’ve deployed the proxy, you can try out the URL of the proxy by clicking the Try It Out button to get the details of the accounts from the HubSpot instances in the browser, as shown here.

Browser Test


Now you’re all set to apply policies to manage your instance.


Editor’s note: This post has been adapted from a section of the book SAP Integration Suite by Christopher Aron, Piyush Gakhar, and Shilpa Vij.


SAP Integration Suite
SAP Integration Suite

SAP’s integration technologies are now combined—but what is the SAP Integration Suite, and how do you use it to manage an integrated enterprise landscape? In this book, get the answers to these questions and more as you take a tour of the new suite. Then learn to use key capabilities such as pre-packaged integrations, open APIs, integration scenarios, the integration advisor, and more. Master the complete integration suite!

Learn More

SAP PRESS is the world's leading SAP publisher, with books on ABAP, SAP S/4HANA, SAP CX, intelligent technologies, SAP Business Technology Platform, and more!