---
title: "Add Webhook Endpoint"
method: POST
path: "/v2/endpoint"
tags: ["Webhook"]
---

# Add Webhook Endpoint

`POST /v2/endpoint`

Create a new webhook endpoint to receive event notifications.
You can specify which events to subscribe to and configure the endpoint URL.

## Request body

- object
  - `url` string, uri, required — Webhook endpoint URL that will receive POST requests
  - `status` 'enabled' | 'disabled', required — Initial status of the webhook
  - `events` string[], required — List of event types to subscribe to

## Response `200`

Success

- object
  - `code` integer, required — Business status code: * 0 - Success * 10104 - Record not found * 10105 - Invalid API key * 18020 - Insufficient credit * 18025 - No permission to call APIs * 40000 - Parameter error * 50000 - System error
  - `msg` string, required — Response message
  - `data` WebhookEndpoint
    - `endpoint_id` string — Unique webhook endpoint identifier
    - `url` string, uri — Webhook endpoint URL
    - `secret` string — Secret key for verifying webhook signatures
    - `status` 'enabled' | 'disabled' — Webhook status
    - `events` string[] — Subscribed event types
    - `username` string — Username of the webhook owner
    - `created_at` integer — Creation timestamp (Unix timestamp)

---

[API](https://skmtc.net/jogg/apis/joggai-openapi-v2.md) · [All operations](https://skmtc.net/jogg/apis/joggai-openapi-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jogg/joggai-openapi-v2/versions/ec8807ce9c12/schema)