---
title: "Create webhook endpoint"
method: POST
path: "/integrations/webhooks"
---

# Create webhook endpoint

`POST /integrations/webhooks`

## Request

- Base URL: `https://app.voteship.app/api/v1`
- URL: `https://app.voteship.app/api/v1/integrations/webhooks`
- Auth: HTTP bearer

## Request body

- object
  - `url` string, required: HTTPS endpoint URL
  - `events` string[], required: Event types to subscribe to, or '*' for all
  - `description` string

## Response `201`

Webhook created (includes full secret)

---

[API](https://skmtc.dev/voteship/apis/voteship-api.md) · [All operations](https://skmtc.dev/voteship/apis/voteship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voteship/apis/voteship-api/revisions/51ab9e650f82?raw)