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

# HTTP tool configuration

> Call an external HTTP service from an agent step with explicit method, URL, authentication, parameters, headers, and timeout settings.

Call an external HTTP service from an agent step with explicit method, URL, authentication, parameters, headers, and timeout settings.

## Prerequisites

* An HTTPS service designed for the tool’s request shape.
* A managed credential when authentication is required.

## Configure an HTTP tool

1. Create an **External HTTP API** tool.
2. Set its method and destination URL, then choose the timeout within the allowed range.
3. Add a credential from the **Authentication** tab when the service requires one.
4. Define parameters, preset values, and custom headers in the **Parameters** tab.
5. Choose a short text or pre-recorded audio message for the wait or result experience, then attach the tool to an Agent node.

## Constraints and failure states

The Console validates the URL and accepts timeouts from 1,000 to 30,000 milliseconds. A request can fail because of validation, authentication, a remote error, or a timeout; the agent needs a recovery path for each case.

## Protect your data

Use a managed credential rather than copying a secret into a header. Send only required parameters and redact sensitive responses before returning them to the conversation.

## Related

* [Tool lifecycle](/voice-agent/tools/introduction)
* [Template variables](/voice-agent/template-variables)
* [Webhook node](/voice-agent/webhook)


## Related topics

- [MCP connections](/integrations/mcp.md)
- [Webhook node](/voice-agent/webhook.md)
- [Tool lifecycle](/voice-agent/tools/introduction.md)
- [Tracing configuration](/configurations/tracing.md)
- [Call transfer tool](/voice-agent/tools/call-transfer.md)