DocsIntegrationsCustom HTTP Tools

Custom HTTP Tools

Tool set: custom_http_toolsDefault: Enabled

Define custom API endpoints that your agent can call. Connect to any external service — CRMs, project management tools, internal APIs.

Setup

In your agent's Settings under Custom HTTP Tools, click Add Tool. Configure name, method, endpoint URL, headers, and input schema.

Responses are recursively redacted before reaching the model or conversation history. Credential-bearing headers, query values, URLs, and password/token/secret/API-key response fields are replaced. Successful POST, PUT, PATCH, and DELETE responses emit a metadata-only custom_http.write_completed event; request and response content is never included.

Free Sample APIs (No Auth Required)

Paste any of these directly into the tool creator to try it out — all are free, public, and require no API key.

1. Open-Meteo — Weather Forecast

Get current weather for any location by latitude and longitude.

Name: get_weather
Method: GET
Endpoint: https://api.open-meteo.com/v1/forecast
Description: Get current weather for a location by coordinates
Input Schema: {
  "latitude": { "type": "number", "description": "Latitude, e.g. 40.71" },
  "longitude": { "type": "number", "description": "Longitude, e.g. -74.01" },
  "current": { "type": "string", "description": "Comma-separated fields, e.g. temperature_2m,wind_speed_10m" }
}

2. REST Countries — Country Info

Look up population, capital, currencies, languages, and flags by country name.

Name: get_country_info
Method: GET
Endpoint: https://restcountries.com/v3.1/name/{name}
Description: Get details about a country by its common name
Input Schema: {
  "name": { "type": "string", "description": "Country name, e.g. 'philippines'" }
}

3. JokeAPI — Random Jokes

Fetch a random joke. Filter by category (Programming, Misc, Dark, Pun, Spooky, Christmas).

Name: get_joke
Method: GET
Endpoint: https://v2.jokeapi.dev/joke/{category}
Description: Get a random joke from a category
Input Schema: {
  "category": { "type": "string", "description": "Any, Programming, Misc, Pun, Spooky, Christmas" }
}

4. Cat Facts — Random Cat Trivia

Get a random fact about cats. No parameters needed.

Name: get_cat_fact
Method: GET
Endpoint: https://catfact.ninja/fact
Description: Get a random cat fact
Input Schema: {}

5. Cataas — Cat Image URL

Returns a random cat image. Add ?json=true for a JSON response with the image URL.

Name: get_cat_image
Method: GET
Endpoint: https://cataas.com/cat?json=true
Description: Get a random cat image URL
Input Schema: {}

6. JSONPlaceholder — Fake REST API

Classic sandbox for testing POST/GET flows. Returns fake posts, users, comments.

Name: create_test_post
Method: POST
Endpoint: https://jsonplaceholder.typicode.com/posts
Headers: { "Content-Type": "application/json" }
Description: Create a fake blog post (sandbox for testing)
Input Schema: {
  "title": { "type": "string", "description": "Post title" },
  "body": { "type": "string", "description": "Post body text" },
  "userId": { "type": "number", "description": "User ID, e.g. 1" }
}

Example With Auth: Slack Webhook

Name: send_slack_message
Method: POST
Endpoint: https://hooks.slack.com/services/YOUR/WEBHOOK/URL
Input Schema: { "text": { "type": "string" } }