Register a Webhook

Register a new webhook to receive notifications for monitoring alerts

post

Allows you to register a new webhook to receive notifications for monitoring alerts. This can include Breach, Identity, and BIN Monitoring alerts.

Authorizations

Body

urlstringRequired

The URL of the webhook to send alerts to when a match is found.

Example: https://mywebhook.com

defaultbooleanOptional

If true, this webhook will be used as the default for all new monitoring requests which do not specify a webhook. This will automatically override any existing default webhook. The first webhook created on an account automatically becomes the default.

Example: false

Responses

201

The call was successful and the webhook is now available for use on your account.

application/json

400

Required parameters were missing or the webhook URL is not a valid URL.

401

You attempted to register a webhook on a domain you have not verified ownership of. The webhook was not created.

409

You attempted to register a webhook with the same URL as an existing webhook. The existing webhook was not modified.

post

HTTPcURLJavaScriptPython

POST /v1/webhooks HTTP/1.1
Host: api.enzoic.com
Authorization: Bearer Base64(your_api_key:your_api_secret)
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "url": "https://mywebhook.com",
  "default": false
}

{
  "webhookID": "5a3ae05132ffb96e664d4626",
  "url": "https://mywebhook.com",
  "key": "51000000000000000000000000000000",
  "secret": "51000000000000000000000000000000",
  "default": false
}