WP Webhooks / Docs / create_webhook
AI Ability since v2.0.0

create_webhook

Create a webhook — Create a new webhook (always created DISABLED until the user enables it).

$

Create a new webhook (always created DISABLED until the user enables it). Provide name, endpoint_url, http_method and triggers. Registered as the WordPress Ability flowsystems-webhook-actions/create-webhook, 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": "create_webhook", "input": { "name": …, "endpoint_url": …, "http_method": …, "triggers": …, "auth_credential_id": …, "custom_headers": …, "url_params": … } }

/ 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
nameparamstringyes
endpoint_urlparamstringyes
http_methodparamstring— GET | POST | PUT | PATCH | DELETE
triggersparamarray—
auth_credential_idparaminteger—
custom_headersparamobject—
url_paramsparamobject—
is_synchronousparamboolean—Delivery mode. false = asynchronous (queued, delivered in the background on the next cron tick, with automatic retries). true = synchronous (delivered inline during the triggering request, so it works without a reliable cron, at the cost of a little latency on that request). Omit to follow the site default.
retry_limitparaminteger—Delivery attempts before the job permanently fails, 1-100. Omit to inherit the site-wide setting, then the default of 5.
backoff_strategyparamstring—How the wait between retries grows. Omit to inherit the site-wide setting, then exponential. exponential | linear | fixed
backoff_base_delayparaminteger—Seconds the strategy multiplies, 1-86400. Omit to inherit, then 30.
backoff_max_delayparaminteger—Ceiling in seconds for exponential backoff, 1-86400. Omit to inherit, then 3600.

/ Examples

Plan step as Build with AI proposes it

{
  "id": "step_1",
  "ability": "create_webhook",
  "summary": "…",
  "input": {
    "name": "CF7 → n8n",
    "endpoint_url": "https://n8n.example.com/webhook/abc123",
    "http_method": "POST",
    "triggers": [
      "wpcf7_mail_sent"
    ]
  }
}

/ Related

Ready

Your next automation is
one sentence away.

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