Webhook - HTTP Request by Apoth3osis

Name: Webhook - HTTP Request
Brand: Apoth3osis
SKU: 695c37c5767df5adfd9bc873
Price: 0.05 USD
Availability: InStock

Webhook - HTTP Request

Core Utility

Available ActionsEach successful request consumes credits as outlined below.

request^5cr

Details

A flexible and secure HTTP client designed for agent-driven API integrations and web service interactions. This function supports all standard HTTP methods including GET, POST, PUT, PATCH, DELETE, HEAD, and OPTIONS, enabling comprehensive RESTful API communication. Users can configure requests with custom headers, query parameters, and request bodies in JSON, plain text, or base64-encoded binary formats. The tool provides four authentication modes: none for public endpoints, basic for username/password credentials automatically encoded to Base64, bearer for OAuth-style token authentication, and header for custom API key or signature-based authentication schemes. Built-in security features include URL validation that blocks private and loopback IP addresses by default (configurable via allow_private), configurable timeouts from 1 to 120 seconds, and response size limits up to 20MB to prevent memory issues. Response handling offers four modes—auto, json, text, and base64—with auto-detection intelligently parsing responses based on content-type headers. The function returns comprehensive response metadata including status code, headers, final URL after redirects, and the parsed body, making it an essential building block for workflows that need to interact with external APIs, webhooks, or web services.

Use Cases

Fetching data from third-party REST APIs for aggregation or transformation pipelines, submitting form data or JSON payloads to webhook endpoints for event-driven workflows, authenticating with OAuth-protected services using bearer tokens for secure integrations, polling external services for status updates or job completion in asynchronous workflows, posting structured data to CRM or marketing automation platforms, retrieving remote configuration files or feature flags from external services, sending notifications to Slack or Discord webhooks with custom message payloads, interacting with payment gateways or e-commerce APIs for order processing, fetching remote JSON schemas or API specifications for validation workflows, integrating with legacy systems via custom header-based authentication for enterprise data exchange

Actions(1)

request^5cr17 params(1 required)

Make an HTTP request to a specified URL. Supports all standard HTTP methods, multiple authentication schemes, and flexible body/response formats.

urlrequiredstring

The full URL to send the request to (must be http or https).

request_methodstring

HTTP method to use.

Values:

GETPOSTPUTPATCHDELETEHEADOPTIONS

Default: GET

headersobject

Custom HTTP headers as key-value pairs.

query_paramsobject

URL query parameters as key-value pairs.

body_jsonobject

JSON object body. Sets Content-Type to application/json automatically. Only one body type allowed per request.

body_textstring

Plain text body payload. Only one body type allowed per request.

body_base64string

Base64-encoded binary body payload. Only one body type allowed per request.

auth_typestring

Authentication scheme to use.

Values:

nonebasicbearerheader

Default: none

auth_usernamestring

Username for basic authentication. Required when auth_type is basic.

auth_passwordstring

Password for basic authentication. Required when auth_type is basic.

auth_tokenstring

Bearer token for authentication. Required when auth_type is bearer.

auth_header_namestring

Custom header name for header-based authentication. Required when auth_type is header.

auth_header_valuestring

Custom header value for header-based authentication. Required when auth_type is header.

timeout_secondsinteger

Request timeout in seconds.

Default: 30

Range: 1 - 120

response_modestring

How to return the response body. Auto detects based on Content-Type.

Values:

autojsontextbase64

Default: auto

max_response_bytesinteger

Maximum response size to return in bytes.

Default: 1048576

Range: 1024 - 20971520

allow_privateboolean

Set to true to allow requests to private or loopback IP addresses.

Default: false

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "695c37c5767df5adfd9bc873",
    "parameters": {
      "action": "request",
      "url": "example_url",
      "request_method": "GET",
      "auth_type": "none",
      "timeout_seconds": 30,
      "response_mode": "auto",
      "max_response_bytes": 1048576,
      "allow_private": false
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "695c37c5767df5adfd9bc873",
    "parameters": {
        "action": "request",
        "url": "example_url",
        "request_method": "GET",
        "auth_type": "none",
        "timeout_seconds": 30,
        "response_mode": "auto",
        "max_response_bytes": 1048576,
        "allow_private": false
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "695c37c5767df5adfd9bc873",
  parameters: {
    "action": "request",
    "url": "example_url",
    "request_method": "GET",
    "auth_type": "none",
    "timeout_seconds": 30,
    "response_mode": "auto",
    "max_response_bytes": 1048576,
    "allow_private": false
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "695c37c5767df5adfd9bc873",
  parameters: {
    "action": "request",
    "url": "example_url",
    "request_method": "GET",
    "auth_type": "none",
    "timeout_seconds": 30,
    "response_mode": "auto",
    "max_response_bytes": 1048576,
    "allow_private": false
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

Webhook - HTTP Request

Overview

A general-purpose HTTP client that can make requests to any public URL. Supports all standard HTTP methods, multiple authentication schemes, flexible body formats, and configurable response handling. Use it to call REST APIs, fetch web resources, post webhooks, or interact with any HTTP-based service.

Actions

request

Make an HTTP request to a specified URL.

Required Fields:

url — the full URL to send the request to (must be http or https)

Optional Fields:

request_method — HTTP method: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS (default: GET)
headers — object of custom HTTP headers (e.g., {"Accept": "application/xml"})
query_params — object of URL query parameters (e.g., {"page": "2", "limit": "10"})
body_json — JSON object body (sets Content-Type to application/json automatically)
body_text — plain text body
body_base64 — base64-encoded binary body (for file uploads or binary data)
auth_type — authentication scheme: "none", "basic", "bearer", or "header" (default: "none")
auth_username — username for basic auth (required when auth_type is "basic")
auth_password — password for basic auth (required when auth_type is "basic")
auth_token — token for bearer auth (required when auth_type is "bearer")
auth_header_name — custom header name for header auth (required when auth_type is "header")
auth_header_value — custom header value for header auth (required when auth_type is "header")
timeout_seconds — request timeout in seconds, 1-120 (default: 30)
response_mode — how to return the response body: "auto", "json", "text", "base64" (default: "auto")
max_response_bytes — maximum response size in bytes, 1024-20971520 (default: 1048576 / 1 MB)
allow_private — set to true to allow requests to private/loopback IPs (default: false)

Note: Only one body field can be used per request (body_json, body_text, or body_base64).

Example — Simple GET request:

{
  "action": "request",
  "request_method": "GET",
  "url": "https://api.example.com/data",
  "query_params": {"format": "json"}
}

Example — POST with JSON body:

{
  "action": "request",
  "request_method": "POST",
  "url": "https://api.example.com/items",
  "headers": {"X-Custom-Header": "my-value"},
  "body_json": {"name": "Widget", "quantity": 5}
}

Example — Bearer token authentication:

{
  "action": "request",
  "request_method": "GET",
  "url": "https://api.example.com/protected/resource",
  "auth_type": "bearer",
  "auth_token": "eyJhbGciOiJIUzI1NiIs..."
}

Example — Basic authentication:

{
  "action": "request",
  "request_method": "GET",
  "url": "https://api.example.com/account",
  "auth_type": "basic",
  "auth_username": "myuser",
  "auth_password": "mypassword"
}

Example — Custom header authentication (API key):

{
  "action": "request",
  "request_method": "GET",
  "url": "https://api.example.com/v2/search",
  "auth_type": "header",
  "auth_header_name": "X-API-Key",
  "auth_header_value": "abc123def456"
}

Example — PUT to update a resource:

{
  "action": "request",
  "request_method": "PUT",
  "url": "https://api.example.com/items/42",
  "body_json": {"name": "Updated Widget", "quantity": 10}
}

Example — DELETE a resource:

{
  "action": "request",
  "request_method": "DELETE",
  "url": "https://api.example.com/items/42"
}

Example — Get binary response as base64:

{
  "action": "request",
  "request_method": "GET",
  "url": "https://example.com/image.png",
  "response_mode": "base64"
}

Response Format

Successful requests return:

status_code — HTTP status code (e.g., 200, 404)
headers — response headers as an object
content_type — the Content-Type header value
url — the final URL (after any redirects)
body_json, body_text, or body_base64 — response body in the format determined by response_mode

Common Workflows

Call a REST API — Use GET/POST/PUT/DELETE with body_json and auth_type to interact with any REST service.
Send a webhook — POST a JSON payload to a webhook URL to trigger external automations.
Fetch a web page — GET any public URL and receive the HTML as text.
Download binary content — GET a file URL with response_mode: "base64" to receive binary data encoded for further processing.
Check endpoint availability — Use HEAD or OPTIONS to verify a service is reachable without downloading the full response body.

Important Notes

Only http and https URLs are supported.
Requests to private or loopback IP addresses are blocked by default. Set allow_private to true to override.
Only one body type can be provided per request. Supplying more than one of body_json, body_text, or body_base64 will cause an error.
When response_mode is "auto", JSON responses are parsed automatically; otherwise text is returned, or base64 for binary content.
Responses exceeding max_response_bytes will be rejected. Increase the limit (up to ~20 MB) for larger payloads.
The maximum timeout is 120 seconds.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Call the AgentPMT-Tool-Search-and-Execution tool with action 'get_schema' and tool_id 695c37c5767df5adfd9bc873 ("Webhook - HTTP Request"). Then call the same tool with action 'call_tool', tool_id 695c37c5767df5adfd9bc873, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Webhook - HTTP Request

Available ActionsEach successful request consumes credits as outlined below.

Details

Use Cases

Actions(1)

Connect Your Agent In 5 Min

Hosted Streamable HTTPS

Local STDIO Fallback

Credit-Based Access Using AgentAddress

Direct x402 Payment

Usage Instructions

Webhook - HTTP Request

Overview

Actions

request

Response Format

Common Workflows

Important Notes

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Workflows Using This Tool

API Healthcheck (JSON) -> Discord Alert

Looking for help integrating AI into your business? Set up a free consultation.