---
title: "POST /outbound-webhooks/endpoints"
method: POST
path: "/outbound-webhooks/endpoints"
tags: ["outbound-webhooks"]
---

# POST /outbound-webhooks/endpoints

`POST /outbound-webhooks/endpoints`

## Request

- Base URL: `https://api.betteroff.finance`
- URL: `https://api.betteroff.finance/outbound-webhooks/endpoints`
- Auth: HTTP bearer

## Request body

- object
  - `url` string, required
  - `events` string[], required

## Response `201`

Success

- object
  - `endpoint` object, required
    - `id` string, uuid, required
    - `url` string, uri, required
    - `events` string[], required: Events to deliver. Each is delivered within five minutes of the change.
    - `disabledAt` string, date-time, nullable, required
    - `consecutiveFailures` integer, required
    - `createdAt` string, date-time, required
  - `secret` string, required: Signing secret. Shown once; store it now.

## Other responses

- `default`: Problem details

---

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