Creating an HTTP Connector

The connector creation window guides you through the configuration when setting up a connector. You can create multiple HTTP-type connectors, each connecting to different external components.

1. In the Project Console's Control panel, click the Connectors button.

The Connectors List view displays.

Project Console’s Control Panel showing the Connectors button highlighted

Figure 1-161   Project Console Control panel - Connectors

2. Click the +Create button.

The Create connector wizard displays.

Project Console’s Control Panel showing a list of connectors with a "+Create" button to add a new connector.

Figure 1-162   Open Create connector wizard

3. In the Name field, input the name of your connector.
4. (Optional) In the Description field, input a description for your connector.
5. In the Type dropdown menu, select Http(s).
6. Select the Next button.

The HTTP configuration window displays.

Figure 1-163   Create connector window- HTTP

7. In the Base path field, input the Base path of the URL.
For instance, if you need to call a REST API to retrieve a specific value, the Base Path could be something like https://MyWebServer/odata. You can specify the remaining part of the URL during flow design.
8. (Optional) In the HTTP headers field, select the Plus icon icon.
8.1. In the Header name field, input the header's name.
8.2. In the Header value, input the header value.
You can specify extra headers to be added to all HTTP request done with the connector.

Figure 1-164   HTTP configuration window - HTTP headers

9. Select the blue Next button.

The HTTP authentication window displays.

Figure 1-165   HTTP configuration window

Define Authentication Type

Decision Point

There are multiple types of authentications that you can utilize to meet your business need.

API key if external service you need to reach is using an API Key to authenticate. Input the API key header name and API key.

Basic type if external service to reach is using a username/password to authenticate.

Bearer token type if the external service to reach uses a bearer token to authenticate.

Digest type if the external service to reach is using Digest authentication.

10. In the Authentication type dropdown menu, select the authentication type.

The Method & body configuration window displays.

HTTP Authentication Wizard

Figure 1-166   HTTP authentication window

For default method Smart Flows supports GET and POST. However, we can also support PUT and DELETE on the HTTP request. You can select the method that best meets your business needs.

GET: Use the GET method to request data from specified resource.

POST: Use the POST method to send data to a server. When you select POST, you can provide a body for the request. If the body needs to contain a dynamic element (i.e., a Linked field), you must configure it at the Flow level. Otherwise, if the body is generic and always the same, you can configure it at the Connector level.

11. In the HTTP method dropdown menu, select the method.
12. Select the blue Next button.

Smart Flows displays the summary of account details.

Figure 1-167   Method and body configuration window - HTTP

13. Select the Finish button to conclude the creation of your HTTP connector.

Figure 1-168   Example of HTTP connector summary