> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowforma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Connection Manager

> Configure API connections in FlowForma Settings by uploading Swagger or OpenAPI files, then use them in the Call External API rule for form integrations.

The API Connection Manager allows you to configure your API connections to make them available for use in the "[Call External API](/product/creating-flows/business-rules/business-rule-types/data-integration-rules/call-external-api)" rule.
The API Connection Manager can be accessed via FlowForma Settings.

## Adding a new connection

When you first open the **API Connection Manager**, it will ask you to provide details for a new API connection.

If you have a **Swagger** or **OpenAPI** file, you can upload this and it will read the file to load the available options it provides,
If you don't have a file, you will just need to enter a connection name, and connection base URL.

<img src="https://mintcdn.com/flowforma/g56Im1vOp6-ECYen/images/developers/api-connection-manager/api-connection-manager-1.png?fit=max&auto=format&n=g56Im1vOp6-ECYen&q=85&s=9c2437c7a16124e52aa0d0f419c4eafc" alt="New API connection dialog" width="1842" height="950" data-path="images/developers/api-connection-manager/api-connection-manager-1.png" />

<img src="https://mintcdn.com/flowforma/g56Im1vOp6-ECYen/images/developers/api-connection-manager/api-connection-manager-2.png?fit=max&auto=format&n=g56Im1vOp6-ECYen&q=85&s=0a38fb2f1311e581467ab3b4a42fcaf9" alt="Swagger file uploaded with auto-populated connection details" width="601" height="218" data-path="images/developers/api-connection-manager/api-connection-manager-2.png" />

Here a swagger file is being uploaded and details are auto-populated for the connection.

<img src="https://mintcdn.com/flowforma/g56Im1vOp6-ECYen/images/developers/api-connection-manager/api-connection-manager-3.png?fit=max&auto=format&n=g56Im1vOp6-ECYen&q=85&s=1ffd29db4f74c4b7339350f77334e2cb" alt="Saved connection details" width="1842" height="950" data-path="images/developers/api-connection-manager/api-connection-manager-3.png" />

Once the connection is save, the next dialogue will display a list of all save connections on the left hand side

The middle panel will display a list of the available requests that can be made

The right panel will display options that can be configured for that request

## Query parameters

<img src="https://mintcdn.com/flowforma/g56Im1vOp6-ECYen/images/developers/api-connection-manager/api-connection-manager-4.png?fit=max&auto=format&n=g56Im1vOp6-ECYen&q=85&s=e726402a9b6af9fcf00c2ff177dd8dc4" alt="Query parameters configuration" width="1143" height="200" data-path="images/developers/api-connection-manager/api-connection-manager-4.png" />

If the request supports parameters, you can list them here, as well as provide a default value

## Headers

<img src="https://mintcdn.com/flowforma/g56Im1vOp6-ECYen/images/developers/api-connection-manager/api-connection-manager-5.png?fit=max&auto=format&n=g56Im1vOp6-ECYen&q=85&s=579dfba15b9a29490d09b63073205be1" alt="Headers configuration" width="1138" height="151" data-path="images/developers/api-connection-manager/api-connection-manager-5.png" />

If the request supports parameters, you can list them here, as well as provide a default value

## Body

<img src="https://mintcdn.com/flowforma/g56Im1vOp6-ECYen/images/developers/api-connection-manager/api-connection-manager-6.png?fit=max&auto=format&n=g56Im1vOp6-ECYen&q=85&s=e1c01f6cee2302b17fa93b3fb8bbc37d" alt="Body configuration" width="1145" height="409" data-path="images/developers/api-connection-manager/api-connection-manager-6.png" />

You can paste in a sample request for the body, this will make it easy to map the questions in your form to fields in the Call External API rule when making a request with information entered into the form.

## Response

<img src="https://mintcdn.com/flowforma/g56Im1vOp6-ECYen/images/developers/api-connection-manager/api-connection-manager-7.png?fit=max&auto=format&n=g56Im1vOp6-ECYen&q=85&s=dded84202a3765484cf7c0c7cf941ec4" alt="Response configuration" width="1143" height="405" data-path="images/developers/api-connection-manager/api-connection-manager-7.png" />

Similarly, you can paste in a sample response from the request, this will make it easy to map the response to questions in your form in the Call External API rule when making a request to display the response in the form.

## Authentication

<img src="https://mintcdn.com/flowforma/g56Im1vOp6-ECYen/images/developers/api-connection-manager/api-connection-manager-8.png?fit=max&auto=format&n=g56Im1vOp6-ECYen&q=85&s=3d0c35ad6beca1f61fe923f44a15a865" alt="Authentication configuration" width="1174" height="248" data-path="images/developers/api-connection-manager/api-connection-manager-8.png" />

Here you can enter in the values required for authentication with the API

* **Basic:** allows you to authenticate using a username & password
* **API Key:** allows you to authenticate using an API Key
* **Bearer Token:** allows you to authenticate using a Bearer Token
* **Client certificate:** allows you to authenticate using a certificate
