HTTP tool configuration

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
• Template variables
• Webhook node