# Create a webhook

> Subscribes a public https URL to the organization events it lists. The response carries the signing secret once; a replay with the same Idempotency-Key returns the webhook without it.

```json
{
  "/webhooks/zapier": {
    "post": {
      "tags": [
        "Webhooks"
      ],
      "summary": "Create a webhook",
      "operationId": "createWebhookZapier",
      "description": "Subscribes a public https URL to the organization events it lists. The response carries the signing secret once; a replay with the same Idempotency-Key returns the webhook without it.",
      "security": [
        {
          "bearerAuth": []
        }
      ],
      "parameters": [
        {
          "$ref": "#/components/parameters/IdempotencyKey"
        }
      ],
      "responses": {
        "201": {
          "description": "Created successfully"
        },
        "400": {
          "description": "Invalid request",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Error"
              }
            }
          }
        },
        "401": {
          "description": "Unauthorized",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Error"
              }
            }
          },
          "headers": {
            "WWW-Authenticate": {
              "$ref": "#/components/headers/WWWAuthenticate"
            }
          }
        },
        "409": {
          "$ref": "#/components/responses/IdempotencyInProgress"
        },
        "422": {
          "$ref": "#/components/responses/IdempotencyKeyReused"
        },
        "429": {
          "$ref": "#/components/responses/TooManyRequests"
        }
      }
    }
  }
}
```