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

# Create a webhook endpoint

`POST /webhooks`

## Request

- Base URL: `https://api.supersendtx.com`
- URL: `https://api.supersendtx.com/webhooks`
- Auth: HTTP bearer

## Request body

- CreateWebhookRequest
  - `url` string, uri, required
  - `events` WebhookEventType[]: Defaults to all supported events if omitted

## Response `200`

Webhook created (signing secret shown once)

- CreateWebhookResponse
  - `webhook` WebhookEndpoint, required
    - `id` string, required
    - `url` string, uri, required
    - `events` WebhookEventType[], required
    - `enabled` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `secret` string, required: Signing secret (`whsec_…`), shown once at creation

## Other responses

- `400`: Missing or non-http(s) `url`, or an unknown event type in `events`
- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/ranla/apis/supersend-tx-api.md) · [All operations](https://skmtc.dev/ranla/apis/supersend-tx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ranla/apis/supersend-tx-api/revisions/e3e782652f50?raw)