Call the Integration API

Developers call the Nimble Fuse API using either the Salesforce or Community Hub URL. The same URL is used for inbound and outbound integration settings.

Authenticated

To access the Nimble Fuse API, we recommend authenticating with Salesforce. An additional user can be created for this.

Authenticate

We suggest using OAuth 2.0 Single Sign-On (external) to authenticate with Salesforce.

Find the Salesforce URL

To access the Nimble Fuse API through Salesforce, the Salesforce URL is used.

From your browser, copy the instance of yourSalesforce org. To learn how to find the instance, see How to tell what instance of Salesforce my Organization is using (external).
Note your Salesforce URL:
https://[SalesforceInstance].salesforce.com/services/apexrest/NUINT/NUIntegrationService

Authenticated Testing

When using an authenticated user, test the integration setting using the REST Explorer in Workbench (external).

Navigate to Workbench (external).
Log into Workbench and allow access to your organization. Workbench is a public site and won’t retain your data.
Click Utilities.
Click REST Explorer.
Set the HTTP method to POST.
In URL, enter /services/apexrest/NUINT/NUIntegrationService

Your full Salesforce URL is not needed because you are authenticated when logged in to Workbench.
In Request Body, enter the JSON payload.
Click Execute.

Non Authenticated

Executing an integration setting through Community Hub should only be done if the Nimble Fuse API needs to be publicly accessible.

Find the Community Hub URL

To access the Nimble Fuse API through Community Hub, the Community Hub URL is used.

From Setup, enter All Communities in the Quick Find box, then select All Communities.
Copy the path from the Community Hub URL.
To create your Nimble Fuse APIURL, append /services/apexrest/NUINT/NUIntegrationService to your Community Hub URL:
For example: https:://staging-jumpstart-154ee1b30db.cs4.force.com/communityhub/services/apexrest/NUINT/NUIntegrationService

Non Authenticated Testing

When using the Nimble Fuse API without an authenticateduser, you can test using a REST client application. We recommend using Postman (external).

In your REST client application:

Execute an Inbound Integration

A JSON request is used to call an inbound integration setting through the Nimble Fuse API.

Create an Inbound JSON Request

The JSON request contains at least three key value pairs:

Key	Value
Name	The name of the integration setting to execute.
Authentication Key	Must match the `Authentication Key`of theintegration setting.
Inbound Records	Contains a collection of key-value pairs for each record to be created or edited. A key-value pair must exist for each each integration inbound setting tied to the integration setting.

Interpret an Inbound JSON Response

The JSON response consists of four properties:

Property	Description
Records	Not used for inbound integrations.
RecordCount	The number of records impacted by the inbound integration call.
Message	Not used for Inbound integrations.
InboundResults	Returns a copy of the data passed to the integration with a reference to the record's Salesforce Id. Results also supply `ErrorMessages` for each record.

Execute an Outbound Integration

A JSON request is used to call an outbound integration setting through the Nimble Fuse API.

Create an Outbound JSON Request

Key	Value
Name	The name of the integration setting to execute.
Authentication Key	Must match the `Authentication Key` of the integration setting.
Parameter	If theintegration setting is using parameters within the `Query`, create a nested key-value pair for each parameter to pass into the integration setting. The `Key` is the parameter name, and the `Value` is the parameter value.

Interpret an Outbound JSON Response