# CreateWebhookSubscriptionInput

input type

Create-input for createWebhookSubscription.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `caption` | [String](/types/#scalars) | no | Optional display caption; omitted ⇒ 'webhook to <target host>'. |
| `targetUrl` | [String](/types/#scalars) `String!` | yes | The https delivery endpoint — the egress law: https only, no credentials, no explicit port, no IP-literal/localhost/private-suffix hosts; ≤512 chars. |
| `eventTypes` | [String](/types/#scalars) `[String!]!` | yes | The event-name filter (1..64, deduped) — every name must be in the DERIVED deliverable universe (transition success events + at.<domain>.<entity>.create.ok.v1 birth names; the integrator docs enumerate it). |
| `pluginId` | [ID](/types/#scalars) | no | Optional Plugin binding — this subscription joins that plugin's declared event feed; the plugin must be a live in-group registration; IMMUTABLE after birth (a re-bind = a new subscription). |

## Used by

- [createWebhookSubscription](/reference/system-and-integration-setup/createWebhookSubscription/)