curl -s -X POST \
  "https://engine.example.com/v1/webhooks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: create-webhook-ops-alerts" \
  -H "Content-Type: application/json" \
  -d '{
    "webhookId": "ops-alerts",
    "url": "https://hooks.example.com/nodeasset",
    "events": [
      "reconciliation.hold",
      "holder.restricted",
      "distribution.paid"
    ],
    "secretFile": "/etc/nodeasset/webhooks/ops-alerts.key"
  }'

// A client from OpenAPI Generator: see Build a client.
import {
  Configuration,
  EventsApi,
  ProblemFromJSON,
  ResponseError,
  WebhookBodyFromJSON,
} from "./nodeasset-client";

const api = new EventsApi(new Configuration({
  basePath: "https://engine.example.com",
  accessToken: process.env.TOKEN,
}));

try {
  const answer = await api.createWebhook({
    // Your id for this action: a retry is the same write.
    idempotencyKey: "create-webhook-ops-alerts",
    webhookBody: WebhookBodyFromJSON({
      webhookId: "ops-alerts",
      url: "https://hooks.example.com/nodeasset",
      events: [
        "reconciliation.hold",
        "holder.restricted",
        "distribution.paid",
      ],
      secretFile: "/etc/nodeasset/webhooks/ops-alerts.key",
    }),
  });
  if (answer.state === "awaiting") {
    // Awaiting approval: it runs once approved.
    console.log("Awaiting approval:", answer.actionKey);
  } else {
    // Follow the operation until it succeeds or fails.
    console.log("Operation:", answer.operationId, answer.state);
  }
} catch (e) {
  if (!(e instanceof ResponseError)) throw e;
  // A refusal is a problem; its type ends in the slug.
  const problem = ProblemFromJSON(await e.response.json());
  const slug = problem.type.split(":").pop();
  console.error(e.response.status, slug, problem.detail);
}

# A client from OpenAPI Generator: see Build a client.
import os
import sys

import nodeasset_client

config = nodeasset_client.Configuration(
    host="https://engine.example.com",
    access_token=os.environ["TOKEN"],
)
with nodeasset_client.ApiClient(config) as client:
    api = nodeasset_client.EventsApi(client)
    try:
        answer = api.create_webhook(
            # Your id for this action: a retry is the same write.
            idempotency_key="create-webhook-ops-alerts",
            webhook_body=nodeasset_client.WebhookBody.model_validate({
                "webhookId": "ops-alerts",
                "url": "https://hooks.example.com/nodeasset",
                "events": [
                    "reconciliation.hold",
                    "holder.restricted",
                    "distribution.paid",
                ],
                "secretFile": "/etc/nodeasset/webhooks/ops-alerts.key",
            }),
        )
        if answer.state == "awaiting":
            # Awaiting approval: it runs once approved.
            print("Awaiting approval:", answer.action_key)
        else:
            # Follow the operation until it succeeds or fails.
            print("Operation:", answer.operation_id, answer.state)
    except nodeasset_client.ApiException as e:
        # A refusal is a problem; its type ends in the slug.
        problem = nodeasset_client.Problem.from_json(e.body)
        slug = problem.type.rsplit(":", 1)[-1]
        print(e.status, slug, problem.detail, file=sys.stderr)

// A client from OpenAPI Generator: see Build a client.
import nodeasset.client.ApiClient;
import nodeasset.client.ApiException;
import nodeasset.client.api.EventsApi;
import nodeasset.client.model.Problem;
import nodeasset.client.model.WebhookBody;
import nodeasset.client.model.WriteAnswer;

public class CreateWebhook {
  public static void main(String[] args) throws Exception {
    ApiClient client = new ApiClient();
    client.updateBaseUri("https://engine.example.com");
    client.setRequestInterceptor(builder ->
        builder.header("Authorization", "Bearer " + System.getenv("TOKEN")));
    EventsApi api = new EventsApi(client);

    try {
      var request = EventsApi.APICreateWebhookRequest.newBuilder()
          // Your id for this action: a retry is the same write.
          .idempotencyKey("create-webhook-ops-alerts")
          .webhookBody(client.getObjectMapper().readValue("""
              {
                "webhookId": "ops-alerts",
                "url": "https://hooks.example.com/nodeasset",
                "events": [
                  "reconciliation.hold",
                  "holder.restricted",
                  "distribution.paid"
                ],
                "secretFile": "/etc/nodeasset/webhooks/ops-alerts.key"
              }
              """, WebhookBody.class))
          .build();
      WriteAnswer answer = api.createWebhook(request);
      if (answer.getState() == WriteAnswer.StateEnum.AWAITING) {
        // Awaiting approval: it runs once approved.
        System.out.println("Awaiting approval: " + answer.getActionKey());
      } else {
        // Follow the operation until it succeeds or fails.
        System.out.println("Operation: " + answer.getOperationId() + " " + answer.getState());
      }
    } catch (ApiException e) {
      // A refusal is a problem; its type ends in the slug.
      Problem problem = client.getObjectMapper()
          .readValue(e.getResponseBody(), Problem.class);
      String type = problem.getType();
      String slug = type.substring(type.lastIndexOf(':') + 1);
      System.err.println(e.getCode() + " " + slug + " " + problem.getDetail());
    }
  }
}