---
title: "Create Webhook Endpoint"
method: POST
path: "/webhook_endpoints"
---

# Create Webhook Endpoint

`POST /webhook_endpoints`

Create a new webhook endpoint

## Request body

- object
  - `url` string — url must be configured like: https://<your-domain.com>
  - `configured_events` object — A json object in the form of `{ topic => [event, …] }`. When not specified, all events are sent to the Webhooks Endpoint. Refer to [Webhooks](https://docs.moderntreasury.com/reference#webhooks) for a list of topics and events.

## Response `201`

201

- object
  - `id` string
  - `object` string
  - `live_mode` boolean
  - `url` string
  - `configured_events` object
  - `webhook_key` string
  - `enabled` boolean
  - `discarded_at` unknown
  - `created_at` string
  - `updated_at` string

## Other responses

- `422` — 422

---

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