---
title: "Create a Webhook"
method: POST
path: "/v1/webhooks"
---

# Create a Webhook

`POST /v1/webhooks`

Use secret API key to create a Webhook

## Request body

- object
  - `data` object
    - `attributes` object
      - `url` string, required — The destination URL of the events that happened from your account. Please make sure that the URL is publicly accessible in order for you to receive the event.
      - `events` string[], required — The list of events to be sent to this webhook. Possible values in the meantime are: Checkout transactions: **`checkout_session.payment.paid`** Transactions: **`source.chargeable`**, **`payment.paid`**, and **`payment.failed`** Refunds: **`payment.refunded`** and **`payment.refund.updated`** Subscriptions: **`subscription.past_due`**, **`subscription.unpaid`**, and **`subscription.updated`** Invoices: **`subscription.invoice.created`**, **`subscription.invoice.finalized`**, **`subscription.invoice.paid`**, and **`subscription.invoice.payment_failed`** PayMongo Links: **`link.payment.paid`** QR Ph codes: **`qrph.expired`**

## Response `200`

200

- object

## Other responses

- `400` — 400

---

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