Create a webhook

URL

POST https://api.complycube.com/v1/webhooks

Creates a new webhook. Returns the webhook endpoint object with the secret field populated. You can create up to a maximum of 20 webhooks.

Headers

Name	Type	Description
Content-Type*	string	The content-type must always be set to application/json.
Authorization*	string	The API live or test key.

Body

Name	Type	Description
url*	string	The URL of the webhook endpoint.
description	string	A description of what the webhook is used for.
enabled*	boolean	Determines whether the webhook should be active.
events*	array	The list of event types to which the endpoint is subscribed for.

Example request

cURL

curl -X POST https://api.complycube.com/v1/webhooks \
     -H 'Authorization: <YOUR_API_KEY>' \
     -H 'Content-Type: application/json' \
     -d '{
          "description": "This is my webhook, I like it a lot",
          "url": "https://yoursite.com/my/webhook/endpoint",
          "enabled": true,
          "events": [
                 "check.pending",
                 "check.completed"
          ]
        }'

Node.js

Python

PHP

.NET

Example responses

Success (200)

{
  "id": "5ed1712e99c81a0007b9a3d6",
  "description": "This is my webhook, I like it a lot",
  "url": "https://example.com/my/webhook/endpoint",
  "enabled": true,
  "events": [
    "check.created",
    "check.completed"
  ],
  "secret": "akuPkDmpn1lFiMchfmSjsQMj0sUQ4IRH"
  "createdAt": "2020-01-29T20:31:42.375Z",
  "updatedAt": "2020-01-29T20:31:42.375Z"
}

Invalid Request (400)