---
title: "Create a Webhook"
method: POST
path: "/network-services/v1/webhooks"
tags: ["Webhooks"]
---

# Create a Webhook

`POST /network-services/v1/webhooks`

This API endpoint creates a new Webhook using details of the receiver such as the endpoint URL and the authMechanism. Auth mechanism can be either API key or OIDC. Use dropdown beside input in body parameters to change authMechanism and provide respective parameters for the authentication type.

## Request body

- WebhookCreateInput — Wrapper for webhook create request input
  - `input` WebhookRequestPayload, required — unresolved $ref

## Response `200`

Creating new webhook.

- WebhookCreateResponse
  - `items` object
    - `id` string, uuid, required — Unique identifier for the webhook.
    - `name` string — Name of the webhook. Must be unique per customer.
    - `type` string, const, required — The API group of the resource.
    - `generation` integer, required — Generation number of the webhook.
    - `createdAt` string, date-time, required — The creation timestamp of the webhook in RFC 3339 format.
    - `updatedAt` string, date-time, required — The last update timestamp of the webhook in RFC 3339 format.
    - `success` boolean, required — Indicates whether the operation was successful.
    - `message` string, required — A message providing additional information about the operation.
    - `hmacKey` string, required — The HMAC key used for signing webhook payloads.

## Other responses

- `400` — Invalid input received.
- `401` — Unauthorized. Authentication credentials are required or invalid.
- `403` — Forbidden: Access is denied.
- `404` — Not Found error.
- `429` — Too Many Requests. The user has sent too many requests in a given amount of time.
- `500` — Internal Server Error. An unexpected error occurred on the server.

---

[API](https://skmtc.net/arubanetworks/apis/authorization.md) · [All operations](https://skmtc.net/arubanetworks/apis/authorization/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arubanetworks/authorization/revisions/74c95058b11f/schema)