Overview
POST/processing/webhooksprocessing

Register a webhook endpoint

Register a new outbound webhook target. The signing secret (`secret`) is returned exactly once in the response — store it; it cannot be retrieved again. The URL must be https:// and resolve to a publicly routable address (SSRF guard).

Auth: bearerAuth — calls run as the authenticated user.

Request body

application/json · optional

  • urlstring

    HTTPS delivery target. Private/loopback/link-local URLs are rejected.

  • eventTypesstring[]

    Event types to subscribe to (e.g. ["job.succeeded", "job.failed"])

  • descriptionoptionalstring

    Optional human-readable label

Example
{
  "url": "string",
  "eventTypes": [
    "string"
  ],
  "description": "string"
}
Responses
201

Webhook endpoint created (secret shown once)

  • idstring
  • ecosystemIdstring

    Ecosystem that owns this endpoint

  • customerIdstring

    User who registered the endpoint

  • urlstring

    HTTPS-only delivery target URL

  • eventTypesstring[]

    Subscribed event types (e.g. job.succeeded, job.failed)

  • activeboolean

    Whether the endpoint receives deliveries

  • descriptionoptionalstring?

    Human-readable label

  • createdAtstring

    ISO 8601 timestamp

  • updatedAtstring

    ISO 8601 timestamp of last modification

  • secretstring

    whsec_-prefixed Standard Webhooks signing secret — returned exactly once. Store it; it cannot be retrieved again.

Example
{
  "id": "string",
  "ecosystemId": "string",
  "customerId": "string",
  "url": "string",
  "eventTypes": [
    "string"
  ],
  "active": true,
  "description": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "secret": "string"
}
400

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X POST "https://api.agenticdeveloperhub.com/processing/webhooks" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "string",
  "eventTypes": [
    "string"
  ],
  "description": "string"
}'
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/processing/webhooks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"url\": \"string\",\n  \"eventTypes\": [\n    \"string\"\n  ],\n  \"description\": \"string\"\n}",
});
const data = await res.json();