# Create a webhook endpoint (/reference/webhooks/create-webhook)

OpenAPI operation (components in https://api.tebar.app/v1/openapi.json):

```json
[
  {
    "operationId": "createWebhook",
    "tags": [
      "Webhooks"
    ],
    "summary": "Create a webhook endpoint",
    "description": "At most 10. The URL must be https on port 443 and a public host (400 webhook_url_not_allowed). profile_id limits it to one profile. The signing secret is returned only here.\n\nRequires the write scope. Owner key or session only: a profile key gets 403 owner_key_required.",
    "parameters": [],
    "requestBody": {
      "required": true,
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/CreateWebhookRequest"
          }
        }
      }
    },
    "responses": {
      "201": {
        "description": "The endpoint with its secret.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/CreatedWebhookEndpoint"
            }
          }
        }
      },
      "400": {
        "$ref": "#/components/responses/BadRequest"
      },
      "401": {
        "$ref": "#/components/responses/Unauthorized"
      },
      "403": {
        "$ref": "#/components/responses/Forbidden"
      },
      "429": {
        "$ref": "#/components/responses/RateLimited"
      }
    }
  }
]
```