---
title: "Create a webhook"
method: POST
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# Create a webhook

`POST /v1/webhooks`

## Request body

- object
  - `url` string, uri, required
  - `event` 'campaign.created' | 'campaign.updated' | 'ticket.created' | 'transaction.succeeded' | 'contact.created' | 'plan.canceled' | 'plan.created' | 'plan.failed' | 'plan.paused' | 'plan.resumed' | 'plan.updated' | 'refund.created'
  - `events` string[]
  - `name` string, nullable
  - `enabled` boolean

## Response `200`

`WebhookResource`

- WebhookResource
  - `id` string, required
  - `name` string, nullable, required
  - `signature` string, nullable
  - `events` unknown[], required
    - unknown
  - `enabled` boolean, required
  - `url` string, required
  - `last_status` string, required
  - `last_status_description` string, required
  - `last_used_at` string, required
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `422` — Validation error

---

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