---
title: "probe_endpoint — AI Ability"
description: "Probe a target endpoint — Make a guarded test HTTP call to validate an endpoint before going live."
url: "https://wpwebhooks.org/docs/ability-probe-endpoint/"
---

[WP Webhooks](/) / [Docs](/docs/) / probe\_endpoint

AI Ability since v2.0.0

# probe\_endpoint

Probe a target endpoint — Make a guarded test HTTP call to validate an endpoint before going live.

Make a guarded test HTTP call to validate an endpoint before going live. To probe a webhook you created, pass webhook\_id (e.g. {{step\_2.id}}) — its URL, credential and method are reused automatically, so never ask the user for the endpoint URL again. Only pass url for an endpoint not tied to a webhook. Defaults to GET/HEAD; other methods require confirmation. Returns status, redacted headers and a truncated, redacted body. The raw secret is never exposed. Registered as the WordPress Ability `flowsystems-webhook-actions/probe_endpoint`, so external AI tools (Claude Code, Cursor) can call it over MCP or REST with a scoped API token.

/ Plan step shape

```
{ "ability": "probe_endpoint", "input": { "webhook_id": …, "url": …, "method": …, "auth_credential_id": …, "headers": …, "body": …, "confirmed": … } }
```

/ Scope & confirmation

Minimum API-token scope for external (MCP/REST) callers: `full`. GET/HEAD probes run without confirmation; other HTTP methods pause for explicit user confirmation.

/ Input fields

| Name | In | Type | Req | Description |
| --- | --- | --- | --- | --- |
| webhook\_id | param | integer | — | Probe an existing webhook by id; reuses its endpoint URL, credential and method. Prefer this over url when probing a webhook you just created. |
| url | param | string | — |  |
| method | param | string | — | GET | HEAD | POST | PUT | PATCH | DELETE |
| auth\_credential\_id | param | integer | — |  |
| headers | param | object | — |  |
| body | param | object | — |  |
| confirmed | param | boolean | — |  |

/ Examples

Plan step as the AI Builder proposes it

```
{
  "id": "step_1",
  "ability": "probe_endpoint",
  "summary": "…",
  "input": {
    "webhook_id": "{{step_2.id}}"
  }
}
```

/ Related

[create\_webhook](/docs/ability-create-webhook/)[test\_dispatch](/docs/ability-test-dispatch/)[REST API reference](/webhook-wordpress-plugin-api/)

/Ready

## Your next automation is  
one sentence away.

[Install Plugin→](https://wordpress.org/plugins/flowsystems-webhook-actions/) [See the Plugin →](/wordpress-webhook-plugin/)

$ wp plugin install flowsystems-webhook-actions --activate

## Structured data

```json
{"@context":"https://schema.org","@type":"TechArticle","name":"probe_endpoint — AI Ability — Webhook Actions Docs","description":"Probe a target endpoint — Make a guarded test HTTP call to validate an endpoint before going live.","url":"https://wpwebhooks.org/docs/ability-probe-endpoint/","isPartOf":{"@type":"WebSite","name":"WP Webhooks","url":"https://wpwebhooks.org"},"about":{"@type":"SoftwareApplication","name":"Webhook Actions","applicationCategory":"WordPress Plugin"}}
```