---
title: "Add user's webhook"
method: POST
path: "/webhooks/user"
tags: ["Webhooks"]
---

# Add user's webhook

`POST /webhooks/user`

## Request

- Base URL: `https://artifacthub.io/api/v1`
- URL: `https://artifacthub.io/api/v1/webhooks/user`
- Auth: API key in header `X-API-KEY-ID` and API key in header `X-API-KEY-SECRET`
- TypeScript: <https://skmtc.dev/artifacthub/apis/artifact-hub/docs/webhooks/user/post.ts> (a function with typed inputs; its response is checked against the schema)

Add user's webhook

## Request body

- WebhookSummaryWithPackages
  - `name` string, required
  - `description` string
  - `url` string, uri, required
  - `secret` string
  - `content_type` string
  - `template` string
  - `active` boolean, required
  - `event_kinds` EventKindId[], required
  - `packages` object[], required
    - `package_id` string, uuid, required

## Response `201`

The request has succeeded and has led to the creation of a resource

## Other responses

- `400`: The request sent was not valid
- `401`: Valid authentication credentials not provided
- `429`: The user has sent too many requests in a given amount of time
- `500`: The server encountered an unexpected condition that prevented it from fulfilling the request

---

[API](https://skmtc.dev/artifacthub/apis/artifact-hub.md) - [All operations](https://skmtc.dev/artifacthub/apis/artifact-hub/llms.txt) - [OpenAPI document](https://skmtc.dev/artifacthub/apis/artifact-hub/revisions/d2e9234264b1?raw)