---
title: "create_webhook — AI Ability"
description: "Create a webhook — Create a new webhook (always created DISABLED until the user enables it)."
url: "https://wpwebhooks.org/docs/ability-create-webhook/"
---

[WP Webhooks](/) / [Docs](/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 REST 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

| Name | In | Type | Req | Description |
| --- | --- | --- | --- | --- |
| name | param | string | yes |  |
| endpoint\_url | param | string | yes |  |
| http\_method | param | string | — | GET | POST | PUT | PATCH | DELETE |
| triggers | param | array | — |  |
| auth\_credential\_id | param | integer | — |  |
| custom\_headers | param | object | — |  |
| url\_params | param | object | — |  |

/ Examples

Plan step as the AI Builder 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

[enable\_webhook](/docs/ability-enable-webhook/)[probe\_endpoint](/docs/ability-probe-endpoint/)[set\_mapping](/docs/ability-set-mapping/)[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":"create_webhook — AI Ability — Webhook Actions Docs","description":"Create a webhook — Create a new webhook (always created DISABLED until the user enables it).","url":"https://wpwebhooks.org/docs/ability-create-webhook/","isPartOf":{"@type":"WebSite","name":"WP Webhooks","url":"https://wpwebhooks.org"},"about":{"@type":"SoftwareApplication","name":"Webhook Actions","applicationCategory":"WordPress Plugin"}}
```