---
updatedAt: 2025-09-10T20:32:59.000Z
agentTools:
  projectIndex: https://developers.cowbellcyber.ai/llms.txt
---

# Register a Webhook

Register a webhook. Auth type and other details required

# OpenAPI definition

```json
{
  "components": {
    "schemas": {
      "WebhookRequestDto": {
        "properties": {
          "authType": {
            "description": "Auth Type. 0=Basic, 1=No Auth, 2=ClientId and Secret",
            "enum": [
              "0",
              "1",
              "2"
            ],
            "type": "string"
          },
          "clientId": {
            "description": "Client Id, if AuthType selected is 2",
            "type": "string"
          },
          "clientSecret": {
            "description": "Client Secret, if AuthType selected is 2",
            "type": "string"
          },
          "description": {
            "description": "Description about webhook.",
            "type": "string"
          },
          "events": {
            "description": "Events for webhook requests. quote.status, policy.status",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "mode": {
            "description": "Mode. 0=Test, 1=Live",
            "enum": [
              "0",
              "1"
            ],
            "type": "string"
          },
          "password": {
            "description": "Password,  if AuthType selected is 0",
            "type": "string"
          },
          "userId": {
            "description": "UserId, if AuthType selected is 0",
            "type": "string"
          },
          "webhookUrl": {
            "description": "Webhook Url",
            "type": "string"
          }
        },
        "required": [
          "authType",
          "events",
          "mode",
          "webhookUrl"
        ],
        "title": "WebhookRequestDto",
        "type": "object"
      }
    }
  },
  "info": {
    "contact": {
      "email": "support@cowbellcyber.ai",
      "name": "Become a Cowbell partner",
      "url": "https://cowbell.insure/contact-us"
    },
    "description": "Cowbell Cyber Insurance APIs for Wholesalers, Digital Aggregators, Brokers, Agencies and Customers",
    "license": {
      "name": "API License",
      "url": "https://cowbell.insure/api-license"
    },
    "title": "Webhooks",
    "version": "v0.9",
    "x-logo": {
      "altText": "Cowbell Cyber",
      "href": "https://cowbell.insure/",
      "url": "https://console.cowbellcyber.ai/logos/CowbellLogo2.svg"
    }
  },
  "openapi": "3.0.3",
  "paths": {
    "/api/outgoingwebhook/v1/webhooks": {
      "post": {
        "description": "Register a webhook. Auth type and other details required",
        "operationId": "addClientWebhookUsingPOST",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Success"
          },
          "400": {
            "description": "Bad Request"
          },
          "401": {
            "description": "Unauthorized"
          }
        },
        "security": [
          {
            "OAuth2": []
          }
        ],
        "summary": "Register a Webhook",
        "tags": [
          "Webhooks API"
        ]
      }
    }
  },
  "servers": [
    {
      "description": "Production Server",
      "url": "https://api.cowbellcyber.ai/"
    },
    {
      "description": "Staging Server",
      "url": "https://api.morecowbell.ai/"
    }
  ],
  "tags": [
    {
      "description": "P100, P250 | REST API to receive webhook requests. Contact apisupport@cowbellcyber.ai if you would like to implement this service.",
      "name": "Webhooks API"
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": true
  }
}
```