# API Automation

The **Infraon API Automation app** allows you to integrate and trigger third-party APIs directly from the **Workflow Automation** module. Once installed, the app provides a central point for managing API-based workflow actions, supporting authentication types such as API Key, Token, and Username–Password.

All API actions triggered from workflows are executed through this app, ensuring a consistent and controlled automation experience.

## **Workflow Automation**

After installation, the **App Integration** card appears as an action block inside workflow configurations.This allows you to integrate external APIs into workflow steps.

### **Authentication Types**

You can select and configure APIs using:

* **API Key-based authentication**
* **Token-based authentication**
* **Username–Password authentication**

### **Configurable Inputs**

For each selected API, you can:

* Enter authentication credentials
* Add custom parameters
* Configure request headers
* Map API inputs to workflow data if required

Once configured, the workflow will trigger the API through the API Automation app when executed.

### **API Response Handling**

<table><thead><tr><th width="229.99993896484375">Category</th><th>Details</th></tr></thead><tbody><tr><td><strong>JSON Responses</strong></td><td><ul><li>If the API returns <strong>application/json,</strong> the system automatically parses the response into JSON for further use.</li></ul></td></tr><tr><td><strong>Other Content Types</strong></td><td><ul><li>For responses such as **text/plain, text/xml,**or other types, the system does <strong>not</strong> attempt JSON parsing.</li><li>The response is processed in its <strong>native format.</strong></li></ul></td></tr><tr><td><strong>Invalid JSON Handling</strong></td><td><ul><li>If an API claims to return JSON but the payload is <strong>invalid,</strong> the system stops parsing and shows a <strong>clear error message</strong> to the user.</li></ul></td></tr></tbody></table>

## **Installation Steps**

**Step 1:** Go to the Marketplace tab on the left navigation panel to begin the integration. Click on the **Infraon API Automation**card from the available integrations to open the plugin details page.

![](https://content.gitbook.com/content/E4mkwSP8a1BSD9BFNFav/blobs/rEJcTuxr0Ze0PGWqvboq/Unknown%20image)

**Step 2:** On the plugin page, click the **Install** button to add the API integration to your Infraon environment.

![](https://content.gitbook.com/content/E4mkwSP8a1BSD9BFNFav/blobs/wEZ7gQKuqmjU1FbYhK0U/Unknown%20image)

Once installed, the configuration page will become available for setup.

**Step 3:** After installation, you must configure APIs within the workflow module. Navigate to the Workflow → [App Integration ](https://docs.infraon.io/infraon-help/infraon-configuration/infraon-automation/workflow/configurations#app-integration)section.

**Step 4:** Configure your API workflows:

* Select the App Integration card in a workflow.
* Choose your authentication method (API Key / Token / Username-Password).
* Enter credentials and any custom parameters.
* Save the configuration and trigger the workflow to execute the API.

To uninstall: return to the Marketplace, open the Infraon API Automation card, and click **Uninstall**. The workflow card and API actions tied to this app will be removed and disabled.