> For the complete documentation index, see [llms.txt](https://angoor-ai.gitbook.io/angoor-ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://angoor-ai.gitbook.io/angoor-ai/basics/configuration/tools/api-tools.md).

# API Tools

External integration utilities that connect third-party services and APIs to your angoor.ai workflows, enabling data exchange and action automation.

You can use it to:

* Get information from 3rd party sources using authenticated APIs
* Send information to your backend systems on specific events.

## Creating API Tools

**Step 1:** Click "New" and select "API Tool" to start configuration.

**Step 2:** Import or define your API schema using URL, file upload, or manual entry.

**Step 3:** Configure authentication method and credentials.

**Step 4:** Map API endpoints to tool functions.

**Step 5:** Test connections and save configuration.

## **API Tool Configuration**

### **Core Tab**

<figure><img src="/files/PaU3WM7xrL2HCTZHsczp" alt=""><figcaption></figcaption></figure>

#### Configuration Process

Import your API schema via URL, file upload, or manual entry to automatically generate tool configurations from OpenAPI/Swagger specifications, saving time and ensuring accuracy in endpoint definitions.

#### Schema Definition

Define available endpoints, HTTP methods, parameters, and response formats to create a complete blueprint of how your tool will interact with the external API and handle data exchange.

#### API Details

Configure base URL, version information, and documentation links to maintain proper API connections and provide reference materials for team members using the tool.

#### Authorization Configuration&#x20;

Set up secure authentication using Basic, Bearer, or Custom methods to ensure your API connections are protected while maintaining ease of use for authorized workflows.

#### Authorization Fields

Specify header names, credential values, and optional flags to handle various API authentication requirements and ensure flexible integration with different service providers.

### Settings Tab&#x20;

Set descriptive names, detailed documentation, and organizational tags to ensure your API tools are easily discoverable and understandable by team members.

<figure><img src="/files/Zfsctw8hpikuC1EV8Jaf" alt=""><figcaption></figcaption></figure>