Invoke External API

Business Background

Titan Flow provides your business with the freedom of choice to invoke an external, custom API of preference. The business edge of using external APIs with Titan is that you work with a broader customer base, not just those that utilize Google Drive, Amazon S3, or OneDrive.

Titan Solution

Titan Flow allows an admin to configure the triggers, parameters, and authentication for an external/custom API.

How to Guide

Any API can be triggered, parameters can be sent, and authentication can be performed. The API’s results can be retrieved, and the response can be mapped to different variables on Titan Flow.

1. Create a new project or open an existing project in Titan Flow.
2. Click the + sign. The Add Node screen opens.

3. Click the Integrations option.
4. Click the Custom API option and click the Next button. The Add Node/Custom API screen opens.

Step 1 – General Customization

5. Paste the endpoint (URL) for the API in the Custom URL field.
6. Select the method from the drop-down list. The options are as follows:
   • Get
   • Post
     • Use a radio button to select one of the formats for the request body. The selected option will determine the format in which the request body will be sent:
       • JSON (default)
       • FormData
   • Put
   • Path
   • Delete
7. If necessary, select a file to upload from the drop-down list. This must be a DocGen file.
8. If necessary, click the Basic authentication checkbox to set the authentication. Currently, only username and password authentication are supported.

9. Click the Next button.

Step 2 – Parameters

10. If necessary, click the Add param button to send data to the Custom API.
    • Type a parameter name in the field to add service parameters.
    • Select the Static or Field from the drop-down list.

11. Click the Next button.

Step 3 – Headers

12. If necessary, click the Add header button to add header parameters.
    • Type a header name in the field to add a service header.
    • Select the Static or Field from the drop-down list.

13. Click the Next button.

Step 4 – API Output Parameters

14. Get back any responses from the API. Invoke the API and map the response to different variables on Titan Flow. Once you have the response in Titan Flow, you can continue the process using the Titan platform.
    • You can select a plain result variable, or
    • do object mapping.

15. Use the drop-down list to select the Plain Result variable. The API result is JSON. All the parameters for the response will be mapped to this variable. You will get the full response from the API and Titan will not do any parsing.

16. As an alternative, do the Object mapping by clicking the Add param option. Titan will parse the values, and you will only get the value from a specified parameter.
    • Add as many fields as necessary.
    • Add specific parameters and map a field to a value by using the drop-down lists.

17. Click the Next button.

Step 5 – Give it a name

18. If necessary, type a tag in the Tag field and click the Insert button.

Custom API is integrated with Titan Flow.