---
title: "POST /api.webhook.v1.WebhookAPI/RegisterNewWebhook"
method: POST
path: "/api.webhook.v1.WebhookAPI/RegisterNewWebhook"
tags: ["api.webhook.v1.WebhookAPI"]
---

# POST /api.webhook.v1.WebhookAPI/RegisterNewWebhook

`POST /api.webhook.v1.WebhookAPI/RegisterNewWebhook`

## Request body

- ApiWebhookV1RegisterNewWebhookRequest
  - `topic` 'EVENT_UNSPECIFIED' | 'EVENT_ORDER_COMPLETED' | 'EVENT_ORDER_CANCELED' | 'EVENT_TRACKING_UPDATED' | 'EVENT_SHIPPING_ADDRESS_UNVERIFIED'
  - `webhookUrl` string, uri
  - `headers` object

## Response `200`

- ApiWebhookV1RegisterNewWebhookResponse
  - `webhookId` string

## Other responses

- `default`

---

[API](https://skmtc.dev/gearment/apis/api-webhook-v1.md) · [All operations](https://skmtc.dev/gearment/apis/api-webhook-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gearment/api-webhook-v1/revisions/a2e58da78818/schema)