---
title: "Add Webhooks"
method: POST
path: "/v1/webhooks"
---

# Add Webhooks

`POST /v1/webhooks`

## Headers

- `Accept` string, required
- `Content-Type` string, required

## Request body

- object
  - `event_types` string[], required — Event that will trigger the web hook. One of those values: invoice.created, charge.created, subscription.created, subscription.updated, plan.created, plan.updated, plan.deleted, discount.created, discount.deleted, customer.created, customer.updated, customer.deleted, customer.card.added, customer.card.updated, customer.card.deleted, dispute.created, dispute.updated, refund.created, token.created, charge.captured charge.voided, subscription.cancelled, invoice.charge.success, invoice.charge.failed, dispute.won, dispute.lost, order.created, order.canceled, order.charged, order.charged.failure
  - `url` string, required — url of the resouce that will be invoked when event ocurs
  - `active` string — if present value is active

## Response `201`

201

- object
  - `data` object
    - `object` string
    - `id` string
    - `event_types` object[]
      - `event_type` string
    - `url` string
    - `created_at` integer
    - `updated_at` integer
    - `enabled` boolean
  - `meta` object
    - `include` unknown[]
      - unknown
    - `custom` unknown[]
      - unknown

## Other responses

- `422` — 422

---

[API](https://skmtc.net/payarc/apis/payarc-sandbox.md) · [All operations](https://skmtc.net/payarc/apis/payarc-sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payarc/payarc-sandbox/versions/face82bdd778/schema)