---
title: "Create webhook"
method: POST
path: "/"
---

# Create webhook

`POST /`

Integrators will use the create Webhook API to provide Ezypay the URL to the weblistener. All events will be delivered to the endpoint provided. Integrators will provide the list of eventTypes that they will want to received the webhook notification. Adding security token:https://developer.ezypay.com/docs/webhook-security

## Headers

- `merchant` string, required

## Request body

- object
  - `url` string, required — The callback url when an event has occurred.
  - `eventTypes` string[], required — List of eventTypes that will trigger a notification when the event occurs. Supported values are: `customer_create`, `customer_update`, `invoice_created`, `invoice_past_due`, `invoice_paid`, `invoice_batch_created`, `invoice_batch_processing`, `invoice_batch_success`, `invoice_batch_invoice_failed`, `subscription_create`, `subscription_cancel`, `subscription_activate`, `payment_method_invalid`, `payment_method_valid`, `payment_method_linked`, `payment_method_replaced`, `payment_method_changed`, `subscription_payment_reactivate`, `subscription_payment_stopped`, `subscription_complete`, `credit_note_created`, `credit_note_paid`, `credit_note_failed`, `partner_invoice_created`, `partner_invoice_paid`, `partner_invoice_past_due`, `qr_response`

## Response `200`

200

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/ezypay/apis/vault.md) · [All operations](https://skmtc.dev/ezypay/apis/vault/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ezypay/vault/revisions/2ca692551cdf/schema)