# Create an OpenAPI tool

> Add a tool from an OpenAPI specification on the Kustomer AI Tools page, then assign it to an AI agent.

Source: https://help.kustomer.com/en_us/create-an-openapi-tool-ryYF1ecAfl

Last updated: 2026-11-17T16:27:19.244Z

**Use this if** an AI agent needs to call an external API. **Outcome:** a tool built from your OpenAPI specification and assigned to an agent.

**Who it is for:** Developers.

## Before you start

*   You have an OpenAPI specification for one API operation.
*   You know if the API needs authentication. See [Add authentication to an OpenAPI tool](https://help.kustomer.com/add-authentication-to-an-openapi-tool-ryiKJl9Rzl).

## Steps

1.  Go to **Kustomer AI** and open **Tools**.
2.  Select **Add a Tool**.
3.  Select **OpenAPI**.
4.  Enter a **Name** and a **Description**. The agent uses both to decide when to use the tool, so make them clear, specific and action-oriented. A good description says what the tool does, when the agent should use it and what information it needs. For example, the name Get Weather Data and the description "Use this tool to get current weather data for a specific city."
5.  Set up **Authentication** if the API requires it.
6.  Provide the **OpenAPI Specification**. It is usually YAML or JSON and describes the endpoint, the parameters and the expected response.
7.  Assign the tool to an AI agent.

## Keep the tool small

Each OpenAPI tool represents one API operation: one server URL, one path and one operation such as GET or POST, depending on what your tool supports. Keep the specification simple and focused. If the agent needs to do several things, create one tool for each. See [OpenAPI features an AI tool does not support](https://help.kustomer.com/openapi-fields-an-ai-tool-supports-rJRYJl50fe).

## Next step

[Add authentication to an OpenAPI tool](https://help.kustomer.com/add-authentication-to-an-openapi-tool-ryiKJl9Rzl)
