WP Webhooks / Docs / preview_snippet
AI Ability since v1.3.0

preview_snippet

Preview (test-run) a Code Glue snippet — Test-run a snippet (by snippet_id, or raw code) against a real captured payload WITHOUT dispatching anything.

$

Test-run a snippet (by snippet_id, or raw code) against a real captured payload WITHOUT dispatching anything. Pass webhook_id+trigger to use that webhook's captured example with its stored field mapping applied — the exact array the snippet gets at dispatch — or provide an explicit payload. Returns input_payload (what the snippet received), the resulting payload, any PHP error and printed output; if the result is identical to input_payload, the code matched nothing. Always preview before assigning. Registered as the WordPress Ability flowsystems-webhook-actions/preview-snippet, so external AI tools (Claude Code, Cursor) can call it over MCP, or over the Abilities REST route with a scoped API token.

/ Plan step shape

{ "ability": "preview_snippet", "input": { "snippet_id": …, "code": …, "webhook_id": …, "trigger": …, "payload": …, "mode": … } }

/ Scope & confirmation

Minimum API-token scope for external (MCP/REST) callers: full. Runs without a confirmation pause (the overall plan is still user-approved before execution starts).

/ Input fields

NameInTypeReqDescription
snippet_idparaminteger—Saved snippet to run; omit when passing code.
codeparamstring—Raw PHP to run instead of a saved snippet.
webhook_idparaminteger—With trigger: use this webhook's captured example payload.
triggerparamstring—
payloadparamobject—Explicit test payload; overrides the captured example.
modeparamstring—Default pre. pre | post

/ Examples

Plan step as Build with AI proposes it

{
  "id": "step_1",
  "ability": "preview_snippet",
  "summary": "…",
  "input": {
    "snippet_id": 4,
    "webhook_id": 12,
    "trigger": "woocommerce_order_status_completed"
  }
}

/ Related

Ready

Your next automation is
one sentence away.

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