ReferenceWebhooks

Create a webhook endpoint

Register a URL. Up to 10 endpoints per workspace.

POST
/duranta.api.public.v1.WebhookService/CreateWebhookEndpoint

Authorization

Authorizationheaderrequired

Bearer token with the sites:scan scope. You get it in exchange for an API key: see Authentication, or press Try in Playground, which takes your key and gets the token for you.

Request body

application/json
  1. body
url*string

The HTTPS URL to send events to. It must resolve to a public address. User info and plain HTTP are rejected. At most 2048 bytes.

description?string

Your note about what the endpoint is for. At most 256 bytes.

Response

Success

application/json
  1. response
endpoint?

A URL on your side that Duranta calls when something happens, so you do not have to poll.

secret?string

The signing secret, whsec_ followed by base64. It is shown only here: store it now. Use it to verify the webhook-signature header of every event, as described by the Standard Webhooks specification.

Create a webhook endpoint
curl -X POST \  'https://app.getduranta.com/duranta.api.public.v1.WebhookService/CreateWebhookEndpoint' \  -H 'Content-Type: application/json' \  -d '{  "url": "string"}'
Response
{  "endpoint": {    "id": "string",    "url": "string",    "description": "string",    "createdAt": "2023-01-15T01:30:15.01Z",    "disabledAt": "2023-01-15T01:30:15.01Z",    "disabledReason": "string"  },  "secret": "string"}