---
title: "Create a webhook subscription"
method: POST
path: "/api/service/webhook-subscription/create"
tags: ["Webhook-Subscription"]
---

# Create a webhook subscription

`POST /api/service/webhook-subscription/create`

Creates a webhook subscription that sends various events from Ivy to a specified url. There can be multiple subscriptions per app.

## Headers

- `Idempotency-Key` string

## Request body

- CreateRequestDto
  - `url` string, required — The endpoint where webhook events are sent.
  - `events` string[] — The events to subscribe the url to.

## Response `200`

Returns the new webhook subscription.

- CreateResponseDto
  - `id` unknown, required
  - `merchant` unknown, required
  - `merchantApp` unknown, required
  - `url` string, required
  - `events` string[], required
  - `createdAt` unknown, required
  - `updatedAt` unknown, required

---

[API](https://skmtc.net/augustus/apis/ivy-api.md) · [All operations](https://skmtc.net/augustus/apis/ivy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/augustus/ivy-api/revisions/c3055fc06ca3/schema)